GORM默认不自动加载关联字段，需显式使用Preload("Users")（字段名大小写敏感）；一对多用foreignKey，多对多需user_groups中间表；Preload支持条件过滤但SQL独立执行，无事务一致性保证。
不加 Preload 就查不到关联字段，这是 GORM 的默认行为，不是 bug，也不是配置遗漏。
为什么 Find() 后 Users 字段是空切片？
GORM 不会自动 JOIN 或子查询填充关联字段。结构体里写 Users []User `gorm:"foreignKey:GroupID"` 只是声明关系，不是启用查询。调用 Find(&groups) 时，GORM 只执行一条 SELECT * FROM groups，groups[0].Users 自然为 []User(nil)。
常见错误现象：
- 日志里看不到任何
SELECT FROM usersSQL - 模板中遍历
.Group.Users报index out of range - 手动加
db.Related(&group.Users)却没效果——因为Related是单条记录的懒加载，不适用于批量结果
Preload("Users") 必须和字段名完全一致
Preload 参数是结构体字段名，大小写敏感，且必须与标签中定义的字段名一致。
正确示例：
type Group struct {
ID int64 `gorm:"primaryKey"`
Name string
Users []User `gorm:"foreignKey:GroupID"`
}
<p>// ✅ 字段名是 Users，所以 Preload("Users")
db.Preload("Users").Find(&groups)
容易踩的坑：
- 字段名写成
users（小写）→ Go 不导出，GORM 直接忽略 - 标签里写
gorm:"many2many:user_groups"，但字段名是UserList→Preload("UserList")才有效，Preload("Users")失败 - 嵌套预加载写成
Preload("Users.Profile")，但User结构体里没有导出的Profile字段 → 静默跳过
一对多 vs 多对多：外键和中间表不能混用
如果你要建“一个 Group 有多个 User”，有两种正确定义方式，选错会导致 Preload 查不到数据或报 foreign key constraint failed：
-
一对多（推荐用于隶属关系）：User 表里加
GroupID uint字段，Group结构体中用Users []User `gorm:"foreignKey:GroupID"` -
多对多（推荐用于角色、标签等松耦合关系）：删掉
User.GroupID，改用连接表：Users []User `gorm:"many2many:user_groups;"`，并确保数据库存在user_groups(group_id, user_id)表，字段名与结构体字段严格对应
关键点：
- 多对多场景下，
user_groups表里的列名必须和你在中间表结构体中定义的字段名一致（如GroupID uint `gorm:"column:group_id"`） - 别指望
many2many:user_groups标签能自动创建表——GORM 迁移不会帮你建中间表，得自己CREATE TABLE或用AutoMigrate配合显式中间结构体
Preload 带条件过滤关联数据
想只加载“状态为 active 的用户”，不能在主查询加 Where("status = ?", "active")，那只会过滤 Group；得把条件传给 Preload：
db.Preload("Users", func(db *gorm.DB) *gorm.DB {
return db.Where("status = ?", "active")
}).Find(&groups)
这会生成第二条 SQL：SELECT * FROM users WHERE group_id IN (1,2,3) AND status = 'active'。
注意：
-
Preload("Users", "status = ?", "active")是简写，等价于上面函数式写法 - 这个条件只作用于
users表，不影响groups查询结果 - 如果要用
JOIN+WHERE一次性筛选（比如“找出至少有一个 active 用户的 Group”），就得换Joins+Where，但此时不能直接填进Group.Users切片——得自己定义接收结构体
最常被忽略的一点：Preload 的 SQL 是独立执行的，它不保证事务一致性。如果主表查完、子表查前有并发写入，可能出现“查到 Group，但没查到刚插入的 User”。需要强一致性时，得上 Transaction 或改用 Joins + 手动映射。
