Update()只更新非零值字段,Save()和Updates()传struct会覆盖零值;应优先用Where()+Updates()精确控制更新,避免意外清空数据。

Update() 只更新非零值字段,小心 struct 零值覆盖
Go 里用 Update() 更新单个字段最安全,但直接传 struct 给 Save() 或 Updates() 会把零值(比如 0、""、nil)也写进数据库,导致意外清空数据。
常见错误现象:User{ID: 123, Name: "Alice", Age: 0} 调 db.Save(&u) 后,数据库里 age 变成 0,哪怕原值是 25。
- 只更新特定字段:用
db.Model(&u).Update("name", "Alice") - 批量更新多个字段(跳过零值):用
db.Model(&u).Select("name", "email").Updates(u) - 强制更新所有字段(含零值):必须显式加
Select("*"),比如db.Model(&u).Select("*").Updates(u)
Save() 不是 UPDATE,它先 INSERT 再 ON CONFLICT(或 REPLACE)
Save() 的行为取决于主键是否已存在 —— 它本质是“UPSERT”,不是单纯的更新。如果你传的 struct 主键为空或数据库里不存在,GORM 会执行 INSERT;否则才走 UPDATE。这在并发或 ID 生成逻辑不稳时容易出错。
使用场景:适合幂等写入,比如缓存同步、日志补录;不适合明确只想改已有记录的业务逻辑。
立即学习“go语言免费学习笔记(深入)”;
- 想确保只更新不插入?别用
Save(),改用Model().Where().Updates() - 主键是自增 int 且你没设
ID字段?Save()一定走插入,不会更新 - 用 UUID 主键时,如果
ID字段为零值(uuid.Nil),同样触发插入
Where() + Updates() 是最可控的更新组合
真正想“按条件改数据”,就老实用 Where() 配合 Updates()。它不依赖 struct 字段状态,也不猜你的意图,只做你明确说的事。
参数差异:Updates(map[string]interface{}) 和 Updates(struct) 行为不同 —— 前者只更新 map 里出现的 key,后者仍会过滤零值(除非加 Select("*"))。
- 推荐写法:
db.Where("id = ?", 123).Updates(map[string]interface{}{"name": "Bob", "updated_at": time.Now()}) - 避免嵌套 struct:不要传
user实例进去,除非你确认每个字段都该写 - 注意时间字段:GORM 默认会自动更新
UpdatedAt,但如果你手动传了updated_at,就得关掉这个行为:db.Unscoped().Where(...).Updates(...)或定义字段 taggorm:"autoUpdateTime:false"
Update() 返回的 RowsAffected 为 0 不一定失败
调 Update() 后 RowsAffected == 0,常见原因不是 SQL 报错,而是 WHERE 条件没匹配到任何记录 —— 比如 ID 不存在、软删除字段 deleted_at IS NOT NULL 导致被过滤。
性能影响:GORM 默认对软删除模型加 WHERE deleted_at IS NULL,如果你要更新已软删除的记录,得先 Unscoped()。
- 检查是否真没查到:
db.Where("id = ?", 123).First(&u)看会不会报record not found - 软删除场景下更新:用
db.Unscoped().Where("id = ?", 123).Update("status", "restored") - 别依赖
error == nil判断成功,一定要看RowsAffected
最容易被忽略的是:GORM 的零值判断基于 Go 类型默认值,不是数据库默认值;而 SELECT * FROM ... 查出来的 struct 如果字段没被赋值,它就是零值 —— 这时候拿它去 Save() 或 Updates(),很容易静默覆盖掉数据库里原本的非空值。


















