gorm 默认不自动加载关联字段，需显式调用 preload 方法才能获取嵌套结构数据；否则 find 查询仅返回主表记录，关联切片为空（如 users 字段为 nil），且数据库中不会生成对应列。
gorm 默认不自动加载关联字段，需显式调用 preload 方法才能获取嵌套结构数据；否则 find 查询仅返回主表记录，关联切片为空（如 users 字段为 nil），且数据库中不会生成对应列。
在 GORM 中，结构体之间的关联（如 Group 包含多个 User）属于一对多关系，但 GORM 不会自动创建或填充关联字段——它不会在 groups 表中添加 users 列（这不符合关系型数据库范式），也不会在查询时自动 JOIN 并填充 Users []User 字段。这是由 ORM 的设计原则决定的：关联字段是逻辑视图，而非物理列。
要正确实现关联查询，必须完成两步：
-
正确定义模型关系（含外键）
当前结构体缺少外键声明和 GORM 标签，无法建立有效关联。应补充 UserID 字段及 foreignKey/joinForeignKey 等标签：
type User struct {
ID int64 `gorm:"primaryKey"`
Name string
}
type Group struct {
ID int64 `gorm:"primaryKey"`
Name string
Users []User `gorm:"many2many:user_groups;"` // 使用连接表实现多对多
// 或若为一对多（每个 User 仅属一个 Group），则：
// UserID uint `gorm:"index"` // 外键字段
// User User `gorm:"foreignKey:UserID"`
}✅ 推荐使用 many2many + 连接表（如 user_groups）实现标准多对多关系，避免数据冗余与一致性问题。
-
显式启用预加载（Eager Loading）
Find()、First() 等方法默认惰性加载（Lazy Loading），即不触发关联查询。必须使用 Preload() 显式声明：
var groups []Group
err := gormConn.Preload("Users").Find(&groups).Error
if err != nil {
log.Fatal(err)
}
// 此时 groups[0].Users 将包含对应用户数据若使用连接表，GORM 会自动生成 SELECT ... JOIN 查询；若为外键一对多，则生成 SELECT ... WHERE user.group_id = ? 子查询。
⚠️ 注意事项：
- Preload 必须在 Find() 前链式调用，顺序不可颠倒；
- 字段名需与结构体中定义的字段名完全一致（区分大小写）；
- 多级嵌套（如 Preload("Users.Posts")）支持链式预加载；
- 避免 N+1 查询：未用 Preload 而在循环中访问 group.Users 将触发多次 SQL 查询。
总结：GORM 的关联不是“自动魔法”，而是需显式建模 + 显式加载。通过 AutoMigrate 创建合理表结构，并始终用 Preload 获取关联数据，才能获得预期的嵌套 JSON 或结构体结果。
