QueryBuilder必须先注册数据库驱动和default连接，否则NewQueryBuilder会panic；Where多次调用会覆盖前置条件；参数顺序须严格匹配?位置；使用Limit必须配合OrderBy主表字段。
QueryBuilder 必须先注册数据库驱动，否则 NewQueryBuilder 会 panic
Beego 的 QueryBuilder 不是独立模块，它依赖已注册的数据库驱动和连接配置。如果跳过 orm.RegisterDataBase 直接调用 orm.NewQueryBuilder("mysql")，会触发 panic: no driver found 或 database not registered。
常见错误现象：
- 程序启动时直接崩溃，日志里没有明确 SQL 错误，只有空 panic
-
qb, _ := orm.NewQueryBuilder("mysql")返回 nil，后续调用qb.Select(...)触发 nil pointer dereference
正确顺序必须是：
- 先
orm.RegisterDriver("mysql", &mysqldriver.Driver{})（通常通过匿名导入自动完成） - 再
orm.RegisterDataBase("default", "mysql", "user:pass@tcp(127.0.0.1:3306)/db?charset=utf8mb4") - 最后才能安全调用
orm.NewQueryBuilder("mysql")
Where 和 And/Or 的参数拼接逻辑容易出错
QueryBuilder.Where 是“重置条件”的入口，后续所有 And、Or 都追加到它之后；但如果你多次调用 Where，前面的条件会被覆盖 —— 这不是 bug，是设计如此。
例如：
qb.Where("age > ?").And("name LIKE ?").Where("status = ?")
最终生成的 WHERE 子句是 WHERE status = ?，前两个条件完全丢失。
正确写法应统一用 Where 开头，后续只用 And/Or：
- 单条件：
qb.Where("age > ?") - 多 AND：
qb.Where("age > ?").And("name LIKE ?").And("status = ?") - 混合逻辑：
qb.Where("age > ?").And("(score >= ? OR level = ?)")（括号必须手动加）
注意：And 和 Or 不接受参数占位符（?），只接受纯字符串表达式，所以动态条件需提前拼好或用 fmt.Sprintf 组装。
执行 QueryBuilder 构造的 SQL 时，Raw 的参数顺序必须严格匹配 ? 出现位置
QueryBuilder.String() 只返回 SQL 字符串，不绑定参数；真正执行时靠 o.Raw(sql, args...).QueryRows(&v) 传参。这里最容易踩的坑是：args 数量或顺序与 SQL 中 ? 个数/位置不一致。
比如构造了：
qb.Select("*").From("user").Where("age > ? AND name = ?").OrderBy("id").Desc()
但执行时写了：
o.Raw(qb.String(), 25).QueryRows(&users)
就会因参数不足导致 MySQL 报错 Error 1048: Column 'name' cannot be null 或静默查不到结果。
建议做法：
- 把参数收集为切片，和构建过程同步维护：
params := []interface{}{25, "alice"} - 执行时统一传入：
o.Raw(qb.String(), params...).QueryRows(&users) - 调试期可先打印
qb.String()和len(params)对照验证
子查询、JOIN 和分页在 QueryBuilder 中不能混用 Offset/Limit + OrderBy
MySQL 5.7+ 要求带 ORDER BY 的 LIMIT 查询必须有确定排序依据，否则可能返回非预期行序。而 Beego 的 QueryBuilder 不校验 OrderBy 是否存在就允许调用 Limit，导致线上分页错乱。
更隐蔽的问题是 JOIN 场景：如果 InnerJoin("profile").On("user.id = profile.user_id") 后未指定 OrderBy("user.id")，仅靠 Limit(10).Offset(20) 可能每次取到重复或遗漏的记录。
安全做法：
- 凡使用
Limit，必须显式调用OrderBy，且字段需来自主表（如user.id），避免用 JOIN 表字段做排序主键 - 子查询别名要用
Subquery方法，不要手拼字符串，否则String()无法识别嵌套层级 - 复杂分页建议改用物理分页（如
WHERE id > ? ORDER BY id LIMIT 10），避开 Offset 性能衰减
QueryBuilder 的链式调用看着流畅，但每个方法背后都是字符串拼接，没有语法树校验 —— 最容易被忽略的是：它不报错，但生成的 SQL 可能语义错误或性能极差。
