Beego ORM 查询结果自动映射需结构体字段导出、类型匹配且 tag 显式声明 column 和 pk;Values 系列不依赖结构体但需手动类型断言;关联字段须显式 LoadRelated;所有模型必须先注册。

Beego ORM 查询结果能自动映射到结构体,但前提是字段名、类型、tag 三者严丝合缝 —— 少一个就空着不填,不会报错也不会提示,查完发现 struct 里全是零值,是最常见的“静默失败”。
结构体字段必须导出且 tag 显式声明 column
小写字段(如 name)完全不会被映射;大写字段(如 Name)也必须用 orm:"column(name)" 明确告诉 ORM “这个字段对应数据库的 name 列”,否则默认按字段名(Name)去查列,而 MySQL 列名通常是小写的。
- ✅ 正确写法:
Name string `orm:"column(name);size(64)"` - ❌ 错误写法:
name string(未导出)、Name string(无 tag)、Name string `orm:"size(64)"`(缺 column) - 注意:即使数据库列名和字段名一致(如
id→Id),仍需写orm:"column(id)",ORM 不做大小写转换或猜测
QueryTable.All() 和 One() 对结构体字段的要求不同
All() 只要求目标切片元素类型有正确 tag;One() 还额外依赖主键 tag —— 如果没标 orm:"pk",即使查到了一行,也会返回 ErrNoRows 或字段全零。
-
One()内部会尝试用主键做校验,没pk就认为“无法确认唯一性”,直接放弃赋值 -
All()不校验主键,但若字段 tag 缺失,对应字段就是零值,且不会报错 - 示例:
type User struct { Id int `orm:"column(id);pk;auto"` Name string `orm:"column(name)"` }——pk和column缺一不可
用 Values() / ValuesList() 时结构体完全无关,但要注意类型对齐
当你调用 o.Raw("SELECT name, age FROM user").Values(&list),list 是 []orm.Params(即 []map[string]interface{}),此时结构体定义毫无作用。但如果你用 ValuesList() 拿二维 slice,就得自己按 SELECT 字段顺序取值,且类型要手动断言。
-
Values()返回的是 map,key 是列名(小写),value 是 interface{},需要类型断言:name := item["name"].(string) -
ValuesList()返回[][]interface{},第一层是行,第二层是列,顺序严格按 SQL SELECT 子句来 - 别指望
Values(&myStructSlice)—— 它只接受[]orm.Params或[]map[string]interface{},不支持直接映射到自定义结构体切片
关联字段(rel / reverse)不会自动填充,除非显式调用 LoadRelated
QueryTable().All() 只查主表,哪怕结构体里写了 Profile *Profile `orm:"rel(one)"`,Profile 字段也永远是 nil —— Beego ORM 不做隐式 JOIN,也不懒加载。
- 必须在
All()后单独调用o.LoadRelated(&users, "Profile") - 如果
Profile是多对一,且users有 100 条,LoadRelated默认发 100 条 SQL(N+1),要避免就得提前用RelatedSel()改写主查 - 想一次查出用户 + 头像 + 订单列表?得组合:
o.QueryTable(&User{}).RelatedSel("Profile").RelatedSel("Orders").All(&users),而不是靠结构体 tag 自动触发
最易被忽略的一点:所有映射都依赖 orm.RegisterModel() 注册过该结构体,哪怕只是用来接收查询结果 —— 没注册,QueryTable(&User{}) 会 panic 报 “model not registered”。











