Preload的Where条件只作用于关联表，需用函数形式传参；Joins的过滤条件必须写在Where中而非ON子句；外键不匹配时需显式声明foreignKey；LIMIT需用子查询实现。
关联查询时 WHERE 条件没生效？检查 Preload 的第二个参数
直接在 Preload 后传入 Where 条件是常见写法，但容易忽略它只作用于关联表（非主表），且必须用函数形式传参。比如查用户及其「未删除」的订单：
db.Preload("Orders", func(db *gorm.DB) *gorm.DB {
return db.Where("deleted_at IS NULL")
}).Find(&users)
错误写法：db.Preload("Orders").Where("deleted_at IS NULL").Find(&users) —— 这个 Where 会作用在 users 表上，对 Orders 完全无效。
- Preload 的条件函数必须返回
*gorm.DB，不能只调用Where就结束 - 条件中字段名默认解析为关联表字段（如
Orders.deleted_at），无需手动加表名前缀 - 若关联字段有别名或需要跨表引用，得用
Joins+Where配合Find，而不是依赖Preload
一对多关联中想限制加载数量（比如只取最新3条订单）
GORM 原生 Preload 不支持 LIMIT，硬加会报错或被忽略。正确做法是用子查询或分步处理：
// 方式一：子查询（推荐，单次 SQL）
db.Preload("Orders", func(db *gorm.DB) *gorm.DB {
return db.Where("id IN (?)",
db.Table("orders").
Select("id").
Where("user_id = users.id").
Order("created_at DESC").
Limit(3)
)
}).Find(&users)
注意子查询里 users.id 能被外层识别，但需确保关联字段名和表名拼写准确（如外键是 user_id，不是 uid）。
立即学习“go语言免费学习笔记（深入）”；
- 不要在 Preload 里直接写
Limit(3)—— GORM 会静默丢弃 - 子查询中
Order和Limit必须同时存在，否则排序无意义 - MySQL 8.0+ 支持窗口函数，可改用
ROW_NUMBER() OVER (PARTITION BY user_id ORDER BY created_at DESC)，但跨数据库兼容性差
使用 Joins 关联查询时 WHERE 条件写在哪？
用 Joins 做 INNER JOIN 或 LEFT JOIN 时，关联表的过滤条件必须放在 Where（或 Having），不能塞进 Joins 字符串里：
// 正确：条件在 Where
db.Joins("LEFT JOIN orders ON orders.user_id = users.id").
Where("orders.status = ?", "paid").
Find(&results)
错误写法：Joins("LEFT JOIN orders ON orders.user_id = users.id AND orders.status = 'paid'") —— 这会导致 LEFT JOIN 变成等效 INNER JOIN，空关联记录被过滤掉。
- JOIN ON 子句只负责关联逻辑；WHERE 才决定最终结果行是否保留
- 如果要保留用户即使没符合条件的订单，WHERE 条件得改成
orders.status = 'paid' OR orders.status IS NULL，并确保orders.*字段允许 NULL - 多个关联表时，每个表的条件都要单独用
Where显式写出，避免歧义
关联字段命名不一致导致 Preload 失败
GORM 默认按结构体字段名 + _id 推导外键，比如 User.Orders 关联到 Order，会找 order.user_id。如果实际字段是 order.creator_id，Preload 会查不到数据且不报错。
必须显式声明外键：
type Order struct {
ID uint `gorm:"primaryKey"`
CreatorID uint `gorm:"column:creator_id"`
User User `gorm:"foreignKey:CreatorID"`
}
-
foreignKey指向当前模型的字段名（CreatorID），不是数据库列名（creator_id） - 如果关联字段是复合主键或软删除字段，还得补
constraint:OnUpdate:CASCADE,OnDelete:CASCADE等，否则 Preload 可能漏数据 - 用
db.Debug().Preload(...).Find(...)打印 SQL，核对生成的 JOIN 条件是否匹配真实字段
关联查询的坑多数藏在隐式约定里——GORM 不报错，但数据就是不对。动手前先看一眼生成的 SQL，比翻文档更快定位问题。
