在 GORM 中使用 Preload 进行关联查询时，必须确保主表查询包含外键关联所需的字段（如 id），否则预加载将失效且不报错——这是初学者最常见的陷阱。
在 gorm 中使用 `preload` 进行关联查询时，必须确保主表查询包含外键关联所需的字段（如 `id`），否则预加载将失效且不报错——这是初学者最常见的陷阱。
GORM 的 Preload 功能用于实现 Eager Loading（急加载），避免 N+1 查询问题。但其底层依赖主模型的主键（默认为 ID）来关联子查询。若使用 db.Select() 限制字段时遗漏了主键或外键关联字段，GORM 将无法构建正确的 JOIN 或子查询逻辑，导致 Preload 被静默忽略——正如示例中仅 Select("name") 后 Addresses 字段为空，且 SQL 日志显示异常条件 ((1 1))，表明预加载因缺失 id 而被跳过。
✅ 正确做法是：始终在 Select 中显式包含主键字段（如 id）及所有关联所需字段。例如：
var users []User
if err := db.Select("id, name").Preload("Addresses").Find(&users).Error; err != nil {
log.Fatal("查询失败:", err)
}
⚠️ 注意事项：
-
Preload("Addresses")默认按Address.UserID关联User.ID，因此User.ID必须存在于主查询结果中； - 若自定义主键（如
gorm:"primaryKey"），需确保该字段被Select包含； - 使用
Preload时避免混用Select("*")与结构体字段过滤，推荐明确列出必要字段以提升可读性与性能； - 可链式调用多次
Preload加载多级关联，如.Preload("Addresses").Preload("Profile")； - 如需条件过滤关联数据，可用
Preload("Addresses", db.Where("city = ?", "New York"))。
? 总结：GORM 预加载不是“魔法”，它严格依赖主模型实例的完整性。只要保证主查询返回有效的主键值，Preload 即可准确触发关联查询并填充嵌套结构。调试时建议开启 db.Debug() 查看实际生成的 SQL，快速定位是否因字段缺失导致预加载失效。
