GORM更新HAS ONE一对一关联的最佳实现方法

• 构造updateData时，传入的Profile结构体没有携带已存在关联记录的主键ID和对应外键UserID，GORM会将主键为零值的结构体识别为全新记录，触发Upsert逻辑而非更新逻辑。
• 直接调用主模型的Updates方法时，GORM默认不会全量更新Has One关联的业务字段，只会维护外键关联关系，因此你传入的新手机号根本没有被带入更新逻辑，最终执行Upsert时用的是预加载查询得到的旧手机号数据。

生产环境优先选择主表、关联表分步更新+事务包裹的方案，逻辑透明可控，不会触发GORM隐式生成的非预期SQL，后续迭代调整字段时不容易出bug。
如果要单条语句完成更新，必须同时满足两个前提：

• 传入的关联结构体必须携带已存在记录的主键、外键值
• 开启FullSaveAssociations配置，显式指定要更新的关联字段，强制GORM同步更新关联表数据

方案1：分步更新（生产推荐） #

var user authmodels.User
// 查询目标用户及关联Profile
if err := database.Db.Joins("Profile").First(&user, "uid = ?", uid).Error; err != nil {
    if errors.Is(err, gorm.ErrRecordNotFound) {
        return c.Status(fiber.StatusNotFound).JSON(er.NotFound(""))
    }
    return c.Status(fiber.StatusBadRequest).JSON(er.BadRequest(err.Error()))
}

// 开启事务保证主表和关联表更新的原子性
tx := database.Db.Begin()
// 更新User主表字段
if err := tx.Model(&user).Updates(map[string]interface{}{
    "first_name": data.FirstName,
    "last_name":  data.LastName,
}).Error; err != nil {
    tx.Rollback()
    return c.Status(fiber.StatusBadRequest).JSON(er.BadRequest(err.Error()))
}

// 更新关联Profile字段，直接使用预加载得到的Profile主键定位记录，不会触发插入
if err := tx.Model(&user.Profile).Update("phone_number", data.Profile.PhoneNumber).Error; err != nil {
    tx.Rollback()
    return c.Status(fiber.StatusBadRequest).JSON(er.BadRequest(err.Error()))
}

// 提交事务
if err := tx.Commit().Error; err != nil {
    return c.Status(fiber.StatusBadRequest).JSON(er.BadRequest(err.Error()))
}

方案2：单语句全量更新 #

适合简单业务场景，注意必须补全关联记录的主键、外键：

updateData := authmodels.User{
    FirstName: data.FirstName,
    LastName:  data.LastName,
    Profile: authmodels.Profile{
        ID:          user.Profile.ID, // 关键：传入已有Profile的主键，避免被识别为新记录
        UserID:      user.ID, // 传入外键值
        PhoneNumber: data.Profile.PhoneNumber,
    },
}

err := database.Db.Session(&gorm.Session{FullSaveAssociations: true}).
    Model(&user).
    // 显式指定要更新的字段，包含关联字段
    Select("FirstName", "LastName", "Profile").
    Updates(updateData).Error
if err != nil {
    return c.Status(fiber.StatusBadRequest).JSON(er.BadRequest(err.Error()))
}

注意：禁止向Updates方法传入主键为零值的关联结构体，GORM对零值主键的结构体统一判定为待插入新记录，必然触发非预期的插入/Upsert逻辑。

内容的提问来源于stack exchange，提问作者Luqman Jr