Preload第二个参数才是过滤入口，主查询Where无效；需为每级Preload显式指定条件，且Select必须包含外键或主键字段，Joins不填充嵌套结构体。
Preload第二个参数才是过滤入口，主查询Where无效
想查“已支付的订单”，写 db.Where("orders.status = ?", "paid").Preload("Orders")
这种写法完全没用——Where 只作用于主表（比如 users），GORM 不会自动把条件下推到预加载子查询里。真正生效的只有 Preload 的第二个参数。
-
db.Preload("Orders", db.Where("status = ?", "paid"))：最简写法，适合单条件 -
db.Preload("Orders", func(tx *gorm.DB) *gorm.DB { return tx.Where("status = ?", "paid").Order("created_at DESC").Limit(5) })：复杂逻辑必须用函数闭包，Limit和Order必须和Where在同一个闭包内，否则被忽略 - 嵌套层级越深，漏条件风险越高：
Preload("Orders.Items", db.Where("price > ?", 50))必须显式写在对应层级，上层条件不会继承
嵌套Preload时每层都要显式加条件，不能靠外层传导
查用户 → 订单 → 订单项，且只要“已支付订单里的高价商品”，很多人误以为只在第一层加 Where 就够了。实际不是。
- 错误：
db.Preload("Orders", db.Where("status = 'paid'")).Preload("Orders.Items")——Items仍是全量加载 - 正确：
db.Preload("Orders", db.Where("status = ?", "paid")).Preload("Orders.Items", db.Where("price > ?", 50)) - 更稳妥：
db.Preload("Orders", func(tx *gorm.DB) *gorm.DB { return tx.Where("status = ?", "paid").Limit(10) }).Preload("Orders.Items", func(tx *gorm.DB) *gorm.DB { return tx.Where("price > ?", 50) })
每级 Preload 的查询是完全独立的，没有隐式上下文传递。
Select字段列表必须包含外键或主键，否则关联失败
加了 Where 还不够，如果同时用了 Select 控制返回字段，漏掉关键字段会导致预加载数据为空或 panic。
- 一对多（如
Orders）依赖外键字段（如user_id），必须出现在Select列表里 - 一对一或
belongs_to依赖主键（如id），同样不能省 - 错误：
db.Preload("Orders", func(tx *gorm.DB) *gorm.DB { return tx.Select("id", "product", "amount").Where("amount > ?", 100) })—— 缺少user_id，关联失败 - 正确：
db.Preload("Orders", func(tx *gorm.DB) *gorm.DB { return tx.Select("id", "user_id", "product", "amount").Where("amount > ?", 100) })
Joins不填充结构体嵌套字段，别指望它替代Preload
Joins("Orders") 只生成 JOIN SQL，不会把订单数据塞进 User.Orders 切片里。这是设计使然，不是 bug。
-
db.Joins("Orders").Find(&users)后，users[0].Orders仍是空切片 - 若需扁平结果（如查用户+最新订单标题），可用
Joins+ 自定义 struct +Scan - 若需嵌套结构（
User{Orders: []Order}），唯一可靠方式是Preload，且条件必须走第二个参数
最容易被忽略的是：预加载是否真正注册成功。开 SQL 日志，看有没有第二条 SELECT * FROM orders WHERE user_id IN (?) —— 没有，说明结构体标签、字段名、外键定义有一处没对齐，不是条件写错了，而是根本没触发预加载逻辑。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
