GORM 关联关系#

常见关系#

关系	示例	外键通常位于
Belongs To	`Order` belongs to `User`	`orders.user_id`
Has One	`User` has one `Profile`	`profiles.user_id`
Has Many	`User` has many `Order`	`orders.user_id`
Many To Many	`User` belongs to many `Role`	中间表，如 `user_roles`

模型示例#

1
type User struct {
2
  ID      uint
3
  Name    string
4
  Profile Profile
5
  Orders  []Order
6
  Roles   []Role `gorm:"many2many:user_roles;"`
7
}
8

9
type Profile struct {
10
  ID     uint
11
  UserID uint
12
  Bio    string
13
}
14

15
type Order struct {
16
  ID     uint
17
  UserID uint
18
  User   User
19
  Amount int64
20
}
21

22
type Role struct {
23
  ID   uint
24
  Name string `gorm:"uniqueIndex"`
25
}

明确写出 UserID 和 User，比完全依赖推断更容易阅读和排查。

Preload 预加载#

1
var users []User
2
err := db.Preload("Profile").
3
  Preload("Orders").
4
  Where("status = ?", "active").
5
  Find(&users).Error

预加载通常会额外执行查询，避免了循环中逐条加载关联记录，但仍要关注返回数据量。可以限制预加载字段或条件：

1
db.Preload("Orders", func(tx *gorm.DB) *gorm.DB {
2
  return tx.Select("id", "user_id", "amount").
3
    Where("amount > ?", 0).
4
    Order("id DESC")
5
}).Find(&users)

嵌套预加载：

1
db.Preload("Orders.Items.Product").Find(&users)

嵌套层级越深，越需要确认查询数量、数据量和 API 返回结构。

Joins 与 Join Preload#

需要按关联表字段筛选、排序或只返回扁平结果时，可以使用 Joins：

1
var orders []Order
2
db.Joins("User").
3
  Where("users.name = ?", "Alice").
4
  Find(&orders)

Preload 主要用于加载关联对象；Joins 主要用于把关联表加入当前 SQL。二者生成的结果结构和 SQL 形态不同，不能只按“哪个查询次数少”机械选择。

创建关联#

1
user := User{
2
  Name: "Alice",
3
  Profile: Profile{Bio: "Go developer"},
4
  Orders: []Order{{Amount: 100}},
5
}
6
if err := db.Create(&user).Error; err != nil {
7
  return err
8
}

不希望自动保存某个关联时：

1
db.Omit("Profile").Create(&user)
2
db.Omit("Roles").Create(&user)

关联写入涉及多条 SQL，关键业务应放在显式事务中，不要只依赖调用方“通常会成功”。

Association Mode#

需要单独管理关联时：

1
db.Model(&user).Association("Orders").Append(&order)
2
db.Model(&user).Association("Orders").Delete(&order)
3
count := db.Model(&user).Association("Orders").Count()

使用前确认主键已经存在，且关联名称与模型字段一致。

关联删除策略#

删除用户时，关联订单是级联删除、软删除、保留还是转移，需要由业务明确决定。数据库外键的 OnDelete 行为和 GORM 的 Select 删除行为不是同一层概念，迁移和测试必须覆盖。

常见坑#

忘记 Preload，导致返回 JSON 中关联为空。
在循环中逐条查询关联，形成 N+1。
Many2Many 中间表的唯一约束缺失，重复关联难以发现。
用 Preload 加载巨大集合，导致内存和响应体爆炸。
关联字段和外键命名不一致却没有显式 foreignKey、references 标签。

HikariTish

GORM 关联关系#

常见关系#

模型示例#

Preload 预加载#

Joins 与 Join Preload#

创建关联#

Association Mode#

关联删除策略#

常见坑#

官方资料#

继续阅读

换条路线

HikariTish

GORM 关联关系#

常见关系#

模型示例#

Preload 预加载#

Joins 与 Join Preload#

创建关联#

Association Mode#

关联删除策略#

常见坑#

官方资料#

分享文章

沿着主题读

换条路线