GORM插入Account时外键约束报错：UserID被替换为随机值

算力阿峰

2026-8-2

问题分析

出现外键约束错误的核心原因：当你在Account结构体中同时赋值User对象和UserID时，GORM执行Save操作会自动处理关联的User对象。由于User嵌入了Base结构体，其BeforeCreate钩子会被触发，生成新的UUID覆盖原User.ID，进而导致Account.UserID被替换为这个未在数据库中存在的新UUID，触发外键约束校验失败。

解决方案

方案1：仅设置`UserID`（推荐）

创建Account时无需传入完整User对象，仅通过UserID关联已存在的用户即可，GORM不会触发User的创建逻辑，也就不会执行BeforeCreate钩子生成新ID：

func Add(u *user.User) (account Account, err error) {
    account = Account{
        UserID:   u.ID,
        Currency: currency.EUR.String(),
        Name:     "Default",
    }
    // 使用Create替代Save，明确执行插入操作
    err = consts.DB.Create(&account).Error
    return account, err
}

方案2：保留`User`关联但禁用自动创建

如果业务需要在Account中保留User关联对象，需明确告知GORM该User是已存在的，避免触发创建逻辑：

func Add(u *user.User) (account Account, err error) {
    account = Account{
        UserID:   u.ID,
        Currency: currency.EUR.String(),
        Name:     "Default",
    }
    // 先创建Account
    if err = consts.DB.Create(&account).Error; err != nil {
        return
    }
    // 关联已存在的User，不会触发创建
    err = consts.DB.Model(&account).Association("User").Append(u)
    return account, err
}