Raw是绕过ORM直连数据库的刚性通道,必须用于复杂SQL(子查询、UNION、窗口函数等);查单条用QueryRow,查多条用QueryRows,字段名须与struct严格匹配;IN查询需动态拼占位符或用SetArgs;UPDATE/DELETE必须用Exec并检查RowsAffected。

Raw 是唯一入口,不是“可选方案”,而是绕过 ORM 映射、直连数据库的刚性通道。所有复杂 SQL(含子查询、UNION、窗口函数、多表 JOIN 带别名、自定义聚合)都必须走它,别指望 QuerySeter 能拼出来。
用 Raw 执行带参数的 SELECT 查询
QueryRow 和 QueryRows 是查单条/多条结构体的主力,但它们对字段映射很敏感:
- 字段名必须和 struct 字段 tag 或命名规则严格匹配(如数据库列 user_name → struct 字段 UserName + orm:"column(user_name)")
- 如果 SQL 里用了别名(SELECT u.name AS username),struct 字段名就得叫 Username,且不能加 column tag,否则映射失败
- NULL 值字段若 struct 中是值类型(如 int),会 panic;必须用指针(*int)或可空类型(sql.NullInt64)
常见错误现象:QueryRow 返回 nil 错误但没报错,实际是字段没对上;QueryRows 返回空 slice 但 num == 0,不等于 SQL 没查到,可能是 struct 字段全为零值被忽略。
实操建议:
- 先用
Values或ValuesList确认 SQL 能跑通、字段能取到,再切到QueryRow - 查单条优先用
QueryRow(&v),查多条用QueryRows(&[]T{}),别传&T{}给QueryRows—— 这会 panic - SQL 中避免
*,显式写字段,并保持顺序与 struct 字段声明顺序一致(Beego 1.1.0+ 不再自动按名匹配,而是按位置)
Values / ValuesList 处理动态字段或无结构数据
当 SQL 结果列不确定(比如报表类查询、跨库 UNION)、或不想定义 struct 时,Values 返回 []orm.Params(map[string]string),ValuesList 返回 []orm.ParamsList([][]string)。
关键限制:
- 所有字段值都是
string类型,NULL 字段值为空字符串"",无法区分 “NULL” 和 “空字符串” -
Values的 key 是数据库列名(原样小写),不是 struct 字段名;如果 SQL 用了别名(AS total_count),key 就是"total_count" -
ValuesList不带 key,靠下标取值,适合导出 CSV 或简单遍历,但易因字段顺序变动出错
性能影响:比 QueryRow 多一次 map 构造和类型转换,大数据量时明显更慢;但开发效率高,调试友好。
IN 查询和参数数量不固定怎么处理?
BeegoRaw 不支持 IN (?, ?, ?...) 动态占位,? 数量必须和传参个数严格一致。硬写 IN (?, ?, ?, ?, ?) 再传 []interface{}{1,2,3} 会 panic。
正确做法只有两个:
- 手动拼接参数占位符:根据
len(ids)生成strings.Repeat("?,", n-1) + "?",再用fmt.Sprintf插入 SQL 字符串(注意防注入:确保ids是整型 slice,不来自用户输入) - 改用
SetArgs复用RawSeter:先定义固定长度占位 SQL,再用SetArgs替换参数 —— 但这只适用于已知最大长度的场景(如最多 100 个 ID)
容易踩的坑:
- 直接传
idsslice 当变参:r.Raw("WHERE id IN (?)", ids)→ 实际传的是[][]interface{},不是展开的参数列表 - 用
strings.Join拼接 ID 字符串进 SQL → SQL 注入高危操作,绝对禁止
UPDATE / DELETE 必须用 Exec,别混用 QueryRow
Exec 是增删改的唯一合法方法,返回 sql.Result,可通过 RowsAffected() 判断是否真有行被修改。
典型错误:
- 对 UPDATE 语句调用
QueryRow→ 报错"sql: expected 0 arguments, got 2"或静默失败 - 忽略
RowsAffected()返回值,以为执行成功就一定改了数据 —— 实际可能 WHERE 条件没命中任何行 - 在事务中执行
Exec后没Commit,导致数据未持久化(尤其用o.Begin()开启事务时)
复杂点在于:Beego 的 Raw 不校验 SQL 类型,Exec 对 SELECT 也不报错,只是返回 0 行影响 —— 这让你很难第一时间发现“本该查却写了改”。


















