Preload带WHERE条件查不到数据是因为Where只作用于主表，正确做法是将条件放入Preload第二个参数；Joins后WHERE会导致LEFT JOIN退化为INNER JOIN，条件应移至ON子句；外键字段名、切片类型、ON/WHERE语义及Preload时机是四大关键点。
Preload 带 WHERE 条件却查不到关联数据
根本不是 SQL 没执行，而是条件没进子查询——db.Preload("Orders").Where("orders.status = ?", "paid") 这种写法完全无效，Where 只作用于主表 users，orders.status 字段在主查询里根本不存在，GORM 甚至不会报错。
正确做法是把条件塞进 Preload 的第二个参数：
-
db.Preload("Orders", db.Where("status = ?", "paid"))—— 最简形式，生成SELECT * FROM orders WHERE user_id IN (?) AND status = ? -
db.Preload("Orders", func(db *gorm.DB) *gorm.DB { return db.Where("status = ?", "paid").Select("id, user_id, amount") })—— 显式指定字段，避免因数据库优化或字段缺失导致绑定失败 - 嵌套层级如
Orders.Items，必须分两步：Preload("Orders")和Preload("Orders.Items", db.Where("quantity > 0"))，合并写成Preload("Orders.Items")在 v1.22 以下会静默忽略
Joins 后 WHERE 条件一加就丢数据
db.Joins("LEFT JOIN orders ON orders.user_id = users.id").Where("orders.status = ?", "paid") 看似合理，实际会让所有没订单或订单非 paid 的用户彻底消失。因为 WHERE 是对 JOIN 后的完整结果集过滤，orders.status IS NULL 的行被直接踢掉，LEFT JOIN 彻底退化为 INNER JOIN。
想保留用户、只过滤关联数据，必须把条件挪到 ON 子句：
立即学习“go语言免费学习笔记（深入）”；
db.Joins("LEFT JOIN orders ON orders.user_id = users.id AND orders.status = ?", "paid")- 若还需查
orders.amount等字段，得显式Select("users.*, orders.amount")，否则 GORM 默认只选主表字段 -
ON里的条件影响 JOIN 结果集；WHERE影响最终输出行——这点和原生 SQL 完全一致，GORM 不做任何“智能转换”
Preload 返回空切片但 SQL 日志里有查询
看到日志里出现了 SELECT * FROM orders WHERE user_id IN (1,2,3)，但 user.Orders 仍是空切片，大概率是外键字段没对齐。
GORM 不靠命名猜，只认 struct tag 和字段值是否严格匹配：
- 父结构体字段
Orders []Order `gorm:"foreignKey:UserID"`，子结构体就必须有导出字段UserID uint，且不能写成User_ID或userid - 如果数据库列名是
user_id，而你又加了gorm:"column:user_id"，那必须同时确保UserID字段类型和父表主键一致（比如都是uint） - 切片类型必须是值类型：
[]Order✅，*[]Order或[]*Order❌——后者不会填充，也不报错，只会静默失效
一对多分页时 Preload 直接失效
db.Limit(20).Offset(100).Preload("Orders").Find(&users) 表面看是查 20 个用户+他们的订单，实际是：先查 20 条用户，再为每条发起一次 IN 查询。这既不是真正分页（关联数据未分页），又极易触发连接池打满、内存暴涨。
真正可行的方案只有两个：
- 用
Joins+Select+Scan：显式拼字段，db.Joins("LEFT JOIN orders ...").Select("users.*, orders.title as order_title").Scan(&results)，再定义对应结构体接收 - 拆成两步：先
SELECT id FROM users LIMIT 20 OFFSET 100得到用户 ID 列表，再SELECT * FROM orders WHERE user_id IN (?)查订单，最后在 Go 层手动聚合 - 高偏移（如
OFFSET 100000）必须改用游标分页，且游标字段（如id）必须单调递增、无重复，created_at需设为毫秒级精度
复杂关联最常卡住的地方，从来不是语法写错，而是外键字段名大小写、切片类型、ON 和 WHERE 语义、以及 Preload 的调用时机这四点——错一个，GORM 就不声不响地返回空切片或错误数据。
