分页必须用 Limit 和 OffsetGORM 无原生 PaginateOffset 表示跳过条数须在 Limit 前调用必须显式 Order 排序前端参数需校验并截断总数查询应独立执行且避免复用链式 DB 实例。分页必须用 Limit 和 Offset别信“自动分页”封装GORM 本身不提供 Paginate 这类开箱即用的分页方法v2 仍无原生支持所谓“自动分页”基本是第三方库或自己写的封装。直接用 Limit 和 Offset 最可控、最透明也最不容易出错。Limit(n) 控制每页取多少条必须显式传整数传 0 或负数会导致查出全表或 panicOffset(m) 表示跳过前 m 条——注意不是“第 m 页”而是“从第 m1 条开始取”所以第 2 页每页 10 条要 Offset(10)不是 Offset(2)顺序很重要Offset 必须在 Limit 前调用才生效GORM v2 中二者顺序可互换但为兼容性和可读性建议固定为 Offset().Limit()没加 Order 的分页结果不稳定数据库不保证无序查询的行序同一页可能漏数据或重复必须显式指定排序字段如 Order(id ASC)前端传 page 和 page_size后端得做安全校验前端 URL 常见形如 /users?page3page_size20但不能直接拿过来算 Offset。用户可能传负数、超大数、非数字或者 page_size 设成 10000 导致慢查询甚至 DB 拒绝服务。用 c.ShouldBindQuery(p) 绑定结构体比手动 c.Query() 更安全能统一做字段验证PageNum 小于等于 0 时强制设为 1PageSize 超过上限比如 100就截断避免被恶意刷别把 page_size 直接透传给 Limit先和配置里的最大值取 min例如 limit : min(p.PageSize, config.MaxPageSize)如果用户传了非法参数如 pageabcShouldBindQuery 会返回 error此时应直接 c.JSON(400, ...)别默默 fallback总数查询不能省但别和列表查写在一个事务里前端分页控件需要总条数来算页码数所以几乎每次分页都要查一次 COUNT(*)。但它和主查询是两个独立 SQL不该共用同一个 *gorm.DB 实例链式调用否则 Where 条件会污染。 Mokker AI AI产品图添加背景