关联数据保存必须显式控制事务边界，否则外键约束失败、部分插入、Hook不触发等问题会立刻出现；GORM默认不递归保存嵌套结构体，需用Transaction+手动赋值外键或CreateInBatches，Avoid直接Create带关联切片的主结构体。
关联数据保存必须显式控制事务边界，否则外键约束失败、部分插入、Hook不触发等问题会立刻出现。
为什么 Create 不能直接保存带关联的结构体
很多人写 db.Create(&order)，其中 Order 结构体嵌套了 Items []OrderItem 并加了 gorm:"foreignKey:OrderID" 标签，结果发现：订单主表插进去了，子表一条没存，也不报错。这是因为 GORM 默认只对主结构体做 INSERT，不会递归处理关联切片——除非你明确告诉它要“级联”。
常见错误现象：
- 数据库报错
ERROR: insert or update on table "order_items" violates foreign key constraint - 主表有记录，子表为空，且无任何 error 返回
-
BeforeCreateHook 在子表上完全没执行
解决办法是用 Select 显式指定字段，并配合事务闭包：
err := db.Transaction(func(tx *gorm.DB) error {
// 先保存主表，拿到生成的 ID
if err := tx.Create(&order).Error; err != nil {
return err
}
// 再批量插入子表，此时 order.ID 已可用
for i := range order.Items {
order.Items[i].OrderID = order.ID
}
if err := tx.CreateInBatches(&order.Items, 100).Error; err != nil {
return err
}
return nil
})
Save 和 Association 的区别在哪
Save 是全量更新（包括主表+所有标记为 gorm:"association" 的字段），但它是“覆盖式”的；Association 是关系管理接口，适合增删改关联项而不碰主表字段。
使用场景：
- 新建订单并绑定已有商品 → 用
Association("Items").Append() - 修改订单收货地址，同时新增两个赠品项 → 用
Save更省事 - 运营后台调整某订单的优惠券，但不改其他字段 → 必须用
Association("Coupons").Replace()
关键差异：
-
Save会触发主表和所有关联结构体的BeforeSave/AfterSaveHook -
Association操作不走主表生命周期 Hook，只触发关联模型自身的 Hook -
Association不支持批量插入，CreateInBatches无法用于Append
嵌套事务里 Association 为什么失效
在 db.Transaction 闭包中调用 tx.Model(&order).Association("Items").Append(...)，看似合理，但实际可能静默失败或漏写数据。根本原因是：GORM 的 Association 方法底层仍会从传入的 *gorm.DB 实例派生新会话，若未显式传递事务上下文，它可能回退到全局 db 实例——也就是非事务环境。
正确做法只有两种：
- 坚持用
tx.Create()+ 手动赋值外键（最可控） - 确保
Association调用对象本身已通过事务句柄加载，例如：tx.Preload("Items").First(&order, order.ID)后再调用Association
性能影响：后者多一次查询，前者少一次 round-trip 但需手动维护外键；高并发扣库存类场景，务必选前者。
软删除关联表时事务怎么写才安全
比如订单取消要逻辑删除主表 + 同时逻辑删除所有子项，而 DeletedAt 字段在子表也存在。这时候如果只对主表调 Unscoped().Delete()，子表不会联动——GORM 不自动传播软删除。
容易踩的坑：
- 用
db.Unscoped().Delete(&order)→ 只删主表，子表还在（且DeletedAt仍是 NULL） - 在
BeforeDeleteHook 里手动删子表 → 若 Hook 报错，主表已删，子表残留，数据不一致
可靠写法是事务内分步操作：
err := db.Transaction(func(tx *gorm.DB) error {
// 1. 更新子表 soft delete
if err := tx.Model(&OrderItem{}).
Where("order_id = ?", order.ID).
Update("deleted_at", time.Now()).Error; err != nil {
return err
}
// 2. 更新主表 soft delete
if err := tx.Model(&Order{}).
Where("id = ?", order.ID).
Update("deleted_at", time.Now()).Error; err != nil {
return err
}
return nil
})
注意：这里不能用 Delete，必须用 Update 显式设 deleted_at，否则 GORM 会尝试物理删除子表（违反外键约束）。
真正麻烦的不是语法，而是每个关联操作背后都藏着外键约束、Hook 触发时机、事务隔离级别三重校验。线上出过问题的人才知道，Association 看似方便，但在事务里它最擅长的就是“假装成功”。
