子查询必须用SubQuery()包裹，不可拼字符串；需通过Session().Model().Select()等构建后封装，支持Where/Joins/Having，不可Scan/Find；Joins中嵌套须配合Table()；参数统一用问号或命名参数；字段须显式AS别名并与结构体tag一致。
子查询必须用 SubQuery() 包裹，不能直接拼字符串
直接在 Where() 或 Joins() 里写 "(SELECT ...)" 字符串，GORM 会当成普通字符串字面量处理，不解析为子查询，甚至可能触发 SQL 注入或语法错误。正确做法是先用 Session().Model().Select().Where().Order().Limit() 构建子查询，再用 SubQuery() 封装。
常见错误现象：panic: unsupported driver type *gorm.expr 或生成的 SQL 中子查询被引号包裹（如 WHERE id IN ('(SELECT id FROM ... )')）。
- 子查询必须基于
db.Session(&gorm.Session{NewDB: true})或显式调用db.Model(&T{}).Select(...)构建，否则上下文丢失 -
SubQuery()返回的是*gorm.DB，可直接传给Where()、Joins()、Having() - 不要对子查询结果再调用
Scan()或Find()—— 它只是构建 SQL 片段，不是执行语句
Joins() 中嵌套子查询需配合 Table() 使用
GORM 的 Joins("LEFT JOIN (SELECT ...) AS t ON ...") 写法不安全：括号会被转义，别名无法绑定字段，且参数占位符失效。应改用 Joins("LEFT JOIN ? AS t ON t.id = users.category_id", db.Table("categories").Select("id, name").Where("status = ?", 1).SubQuery())。
使用场景：需要关联一个动态过滤后的维度表（如“最近活跃的标签”“用户所属最高权限角色”），而非固定表。
-
Table()是关键——它让 GORM 知道子查询要映射到哪个模型，从而正确处理字段别名和类型推导 - 子查询中若含
ORDER BY+LIMIT（如取每个分类下最新一条记录），必须确保外层Joins()的 ON 条件能引用子查询字段（GORM 会自动加别名t.*） - 避免在子查询里用
Preload()—— 子查询上下文不支持关联预加载
带参数的子查询必须统一用命名参数或问号，不能混用
例如 db.Where("id IN (?)", db.Model(&User{}).Select("id").Where("created_at > ?", time.Now().AddDate(0,0,-7)).SubQuery()) 是安全的；但若子查询里用命名参数 sql.NamedArg，而外层用问号，GORM 无法合并参数，会报 sql: expected 1 arguments, got 2。
性能影响：子查询本身不额外增加 round-trip，但复杂嵌套可能导致 MySQL 执行计划退化（如无法使用索引），建议开启 db.Debug().Exec(...) 查看实际生成 SQL 并用 EXPLAIN 验证。
- 统一用问号最稳妥，尤其在 Gin controller 中接收多个 query 参数时，可直接透传给子查询
- 若主查询用命名参数（如
map[string]interface{}{"name": c.Query("name")}），子查询也必须用相同风格，且 key 不得冲突（如都叫"name"） - 子查询中禁止出现未绑定的变量（如
fmt.Sprintf("status = %d", status)）——这是 SQL 注入高危点
子查询结果作为字段值时，要用 Select() 显式声明别名
比如想查用户列表并附带“该用户发布的文章数”，不能写 db.Select("users.*, (SELECT COUNT(*) FROM articles WHERE user_id = users.id) as article_count") —— GORM 无法解析这种裸 SQL 表达式。正确方式是：
db.Table("users").
Select("users.*", "article_counts.count AS article_count").
Joins("LEFT JOIN (?) AS article_counts ON article_counts.user_id = users.id",
db.Table("articles").Select("user_id, COUNT(*) AS count").Group("user_id").SubQuery()).
Find(&users)
容易踩的坑：别名没加 AS 或大小写不一致，导致 Scan 时字段匹配失败（article_count vs ARTICLE_COUNT）；子查询返回多列但未全部声明，MySQL 可能报错或静默截断。
- 所有子查询字段必须显式
AS别名，且与 Go 结构体字段 tag（如json:"article_count"）保持一致 - 若子查询只返回单个标量（如 COUNT），仍需
AS，否则 GORM 无法映射到结构体字段 - 避免在
Select()中混用模型字段（users.*）和子查询字段——部分数据库不支持，GORM 也不保证顺序
IN 查子集，反而更可控、易调试。 
