动态字段过滤需用map或手动拼SQL,避免硬编码;Offset+Limit分页性能差且结果不可靠;游标分页更健壮但需自定义实现;分页参数必须严格校验。

动态字段过滤:用 map 或结构体构建 WHERE 条件
GORM 不支持直接把未知字段名拼进 SQL,所以不能写 db.Where("?? = ?", fieldName, value) 这种带变量列名的表达式。必须靠 map[string]interface{} 或手动拼条件字符串。
常见错误现象:前端传 status=active&category=tech,后端硬编码 .Where("status = ? AND category = ?", ...) —— 一旦新增字段就得改代码,维护成本爆炸。
- 安全做法是用
map[string]interface{}构造过滤条件,GORM 会自动忽略值为零值(0、""、nil)的 key:db.Where(filterMap).Find(&users) - 若需支持模糊匹配(如
name LIKE '%xxx%'),得手动拼:if p.Keyword != "" { db = db.Where("name LIKE ?", "%"+p.Keyword+"%") } - 注意
map无法表达IN、IS NULL、范围查询(BETWEEN)等,这些必须单独判断并调用.Where("field IN ?", ids)等显式方法
Offset + Limit 分页:为什么它“能用但不该长期用”
最直白的分页就是 Offset((page-1)*size).Limit(size),但它在数据频繁变更或量级上升后会出问题——不是 GORM 的 bug,而是 SQL 本身缺陷。
典型表现:翻到第 50 页时某条记录突然消失;并发插入新数据后,同一页请求两次结果不一致;OFFSET 100000 查询耗时从 20ms 涨到 2s+。
- 根本原因是数据库要扫描并丢弃前 N 行,行数越多,I/O 和 CPU 开销越大
- 必须加
.Order("id ASC")或.Order("created_at DESC, id DESC"),否则无序分页结果不可预测 -
Count(*)查询不能复用带Limit/Offset的 db 实例,否则得到的是“当前页数量”,不是总数。正确写法是:db.Session(&gorm.Session{NewDB: true}).Model(&User{}).Where(...).Count(&total)
游标分页:用主键/时间戳替代页码
当列表有明确排序依据(比如按创建时间倒序),且前端愿意配合传“上一页最后一条的 created_at 和 id”,就该切到游标分页。它绕开了 OFFSET 的性能陷阱,也天然规避漏数据问题。
示例逻辑:前端第一次请求不带游标,后端返回 list: [...], cursor: "2026-08-20T10:30:00Z|12345";下一次请求带上 cursor=2026-08-20T10:30:00Z|12345,后端解析后生成:WHERE created_at
- 必须确保
ORDER BY字段组合有联合索引,否则照样慢 - 游标值不能只用时间戳(精度不够、可能重复),必须搭配唯一字段(如
id)做二级排序和边界判断 - GORM 不内置游标分页支持,得自己封装解析和 WHERE 构建逻辑,别指望第三方库替你处理边界 case
分页参数校验:别让 page=999999 直接进数据库
前端 URL 里的 page 和 page_size 是不受控输入。GORM 不做任何拦截,传啥它就拼啥。
后果很直接:page=0 导致 Offset(-10) panic;page_size=10000 触发 MySQL max_allowed_packet 拒绝或拖垮连接池。
- 用
c.ShouldBindQuery(&p)绑定结构体比c.Query("page")更安全,能统一做 tag 验证(如validate:"min=1,max=100") - 没传
page时默认为 1,page_size超过配置上限(如 100)就截断,而不是报错中断流程 - 避免用
strconv.Atoi手动转——空字符串或非数字会 panic,ShouldBindQuery自动处理类型转换和错误返回
游标分页的健壮性远高于页码分页,但改造成本高;Offset+Limit 简单直接,却在数据量破十万、并发写入频繁时变成定时炸弹。真正难的不是写对一行 Offset,而是判断当前业务到底该信页码,还是信游标。











