Golang用Save和Update修改数据教程

本文深入解析了 Golang 中使用 GORM 进行数据更新的三大核心方法（Save、Update、Updates）的关键差异与常见陷阱，重点揭示了零值字段（如 0、""、nil）在 struct 传递时被意外写入数据库导致数据清空的风险，并强调 Where() + Updates() 是最安全、最可控的更新模式；同时澄清 Save() 实为 UPSERT 而非纯 UPDATE，指出软删除场景需 Unscoped()、时间字段需显式控制自动更新、RowsAffected 为 0 并不等于失败等易被忽视的实战细节，帮助开发者避开生产环境中的静默数据丢失和逻辑错乱。

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 生成逻辑不稳时容易出错。

使用场景：适合幂等写入，比如缓存同步、日志补录；不适合明确只想改已有记录的业务逻辑。

• 想确保只更新不插入？别用 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(...) 或定义字段 tag gorm:"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()，很容易静默覆盖掉数据库里原本的非空值。

今天关于《Golang用Save和Update修改数据教程》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！