QueryTable.All() 必须传结构体切片地址,如 &users;字段映射依赖 orm tag 且字段必须导出;不报错但可能结果为空、截断(默认上限1000条)或字段为零值。

QueryTable.All() 必须传结构体切片地址,不是结构体本身
直接传 user 或 &user(单个结构体)给 All() 会 panic 或静默失败 —— 它只接受切片的地址。常见错误是写成 o.QueryTable("user").All(&user),但 user 是 User 类型变量,不是切片。
正确做法是提前声明一个空切片并取其地址:
-
var users []models.User→ 传&users -
users := make([]models.User, 0)→ 传&users - 不能用
new([]models.User),因为那是指向切片头的指针,不是切片本身地址
字段不匹配时 All() 不报错但结果为空或字段为零值
All() 对数据库字段和结构体字段的映射完全依赖 struct tag,比如数据库列叫 user_name,但结构体字段是 UserName 且没加 orm:"column(user_name)",那这个字段永远读不到,也不会提示缺失映射。
容易踩的坑:
- 结构体字段名首字母小写 → 不导出 → ORM 直接忽略该字段(哪怕 tag 写对了)
- 数据库字段是
created_at,结构体字段叫CreatedAt,但 tag 漏了orm:"column(created_at)"→ 字段值始终为零 - 用了
ValuesList()却传结构体切片地址 → 运行时报类型不匹配 panic
指定返回字段时,All() 第二个参数必须与结构体字段一一对应
调用 qs.All(&users, "name", "age") 时,users 切片中每个 models.User 的 Name 和 Age 字段会被填充,其余字段保持零值。但前提是:
-
"name"必须对应结构体中带orm:"column(name)"的导出字段(如Name) - 字段名大小写要严格匹配 tag 中的
column值,"Name"≠"name" - 如果传了
"id"但结构体里没有标记orm:"column(id)"的字段,该字段不会被赋值,也不报错
超过1000条数据时 All() 自动截断,且不警告
All() 默认最多返回 1000 条记录,超出部分直接丢弃。这在测试环境不易察觉,上线后查“明明有2000条数据却只拿到1000条”时才暴露。
解决方式只有两个:
- 显式加
.Limit(n),比如.Limit(5000)(最大支持值取决于驱动和 MySQL 配置) - 分页查:用
.Limit(100).Offset(0)、.Limit(100).Offset(100)等组合 - 别指望
All()自动处理大数据量 —— 它设计上就不是为全量扫描准备的
实际使用中最容易被忽略的是:结构体字段未导出 + tag 缺失 + 超限截断三者叠加,导致查询看似成功、结果却为空或不完整,而日志和返回值都不报错。











