GORM如何插入带深度嵌套一对多关系的模型

核心故障原因 #

• 外键类型不匹配：当前Page结构体中的BookID字段定义为string类型，但关联主表Book的主键ID类型为uuid.UUID，类型不一致会导致GORM无法识别二者的外键关联关系，直接跳过关联数据写入。
• 嵌套关联默认不递归全量保存：GORM默认的Create逻辑仅处理单层关联，两层及以上的嵌套一对多关联（Book->Page->Word属于两层嵌套），需要手动开启全量关联保存配置，否则只会写入最上层主表数据。
• 关联推断偏差：GORM默认外键命名规则依赖字段名、字段类型双重匹配，若类型不匹配或缺少明确声明，很容易出现关联识别失败的问题。

修复步骤 #

1. 修正外键字段类型，保证和关联主键类型完全对齐
   将Page结构体里的BookID类型从string改为uuid.UUID，和Book.ID类型保持一致。
2. 显式添加GORM关联标签，避免关联推断错误
   修正后的完整结构体参考如下：

import (
    "time"
    "github.com/google/uuid"
    "gorm.io/gorm"
)

type Book struct {
   ID                uuid.UUID      `gorm:"type:uuid;primaryKey"`
   Pages             []*Page        `gorm:"foreignKey:BookID;references:ID"`
   CreatedAt         time.Time
   UpdatedAt         time.Time
   DeleteRequestedAt gorm.DeletedAt `gorm:"column:delete_requested_at"`
}

type Page struct {
   ID      uuid.UUID `gorm:"type:uuid;primaryKey"`
   BookID  uuid.UUID `gorm:"type:uuid;column:book_id"`
   PageNum int
   Words   []*Word   `gorm:"foreignKey:PageID;references:ID"`
}

type Word struct {
   ID      uuid.UUID `gorm:"type:uuid;primaryKey"`
   PageID  uuid.UUID `gorm:"type:uuid;column:page_id"`
   Letters []byte
}

3. 开启全量关联保存开关执行写入
   调用Create时在会话层开启FullSaveAssociations配置，确保两层嵌套关联都会被递归写入：

err := db.Session(&gorm.Session{FullSaveAssociations: true}).Create(&hydratedBook).Error
if err != nil {
    // 按需处理错误
}

额外检查项 #

• 确认填充完成的hydratedBook中，Pages切片非空，且每个Page元素下的Words切片也非空，避免因数据填充遗漏导致无关联数据写入。
• 检查全局GORM配置或当前会话配置中没有开启SkipAssociations: true参数，该参数会强制跳过所有关联逻辑处理。

内容的提问来源于stack exchange，提问作者js-sp