GORM 零值更新与 required 校验:两个方向的坑
后台把文章状态改成 0,接口返回成功,列表里却还是原来的状态;另一个接口把状态作为必填参数,前端明确传了 0,却被提示“不能为空”。
这两个现象看起来矛盾,其实是两个默认值规则在相反方向上生效:GORM 的 Updates 会跳过零值,validator 的 required 会把零值当成空。下面用 GORM 1.31.2、validator v10.27.0 和 MySQL 8 的最小复现,把两边拆开。
状态改回 0,数据库没变
先看更新。假设文章表有 status 字段,1 是发布,0 是草稿:
type Article struct {
ID int64 `gorm:"column:id;primaryKey"`
Status int64 `gorm:"column:status"`
}
db.Model(&Article{}).Where("id = ?", 1).Updates(Article{Status: 0})
这条语句不会把 status 改成 0。GORM 对结构体参数的默认语义是“只更新非零字段”,int64 的 0、空字符串、false、nil 指针都会被跳过。实际执行的 SQL 里根本没有 SET status = 0,接口却不会报错。
同样的更新换成 map 就会生效:
db.Model(&Article{}).Where("id = ?", 1).Updates(map[string]any{"status": 0})
最小复现可以直接在临时表里跑。下面的输出来自本项目开发库的临时表,GORM 版本 1.31.2:
Updates(struct status=0) => status=1
Updates(map status=0) => status=0
| 写法 | 0 值是否写入 | 适合的场景 | 主要风险 |
|---|---|---|---|
Updates(struct) | 否 | 只改少数非零字段 | 状态归零、排序归零、字符串清空都会静默失败 |
Updates(map) | 是 | 局部更新、状态流转 | 键名写错时 GORM 不会校验字段是否存在 |
Save(entity) | 是 | 后台表单整行保存 | 未带的字段会被写成零值或 NULL |
Save 看起来最省事,但它是整行覆盖。本项目里文章更新使用 Save,同时用 Omit 排除不允许改的列:
func (r *articleRepository) Update(ctx context.Context, entity *domain.Article) error {
return r.db.WithContext(ctx).
Omit("creator", "create_time", "tenant_id").
Save(entity).Error
}
这段代码能成立,前提是请求体带齐了可编辑字段。如果只想改一个状态,传一个只填了 ID 和 Status 的实体给 Save,标题、正文、SEO 字段都会被清空。
文件配置模块还遇到了另一个方向的问题:主配置标记 master 不允许在普通编辑里改变。服务层在转换后手动把原值写回去,避免 Save 把它覆盖成 0:
updateObj := dto.ToFileConfigEntity(req)
updateObj.Master = config.Master // 主配置标记不随配置的更新而改变
if err = s.repo.Update(ctx, updateObj); err != nil {
return err
}
这类字段如果交给 Updates(struct),结果同样不可靠:master 本来就是 0/1,改成 0 会被跳过,改成 1 才生效。更新语义必须和字段含义一起设计,不能只看代码是否“跑通”。
required 把 0 当成了空值
再看校验。下面两个请求结构体,只差一个指针:
type SaveInt struct {
Status int64 `json:"status" validate:"required"`
}
type SavePtr struct {
Status *int64 `json:"status" validate:"required"`
}
用 validator 直接验证,结果如下:
required int64=0 => Key: 'SaveInt.Status' Error:Field validation for 'Status' failed on the 'required' tag
required *int64=0 => <nil>
required *int64=nil => true
required 判断的是“是否等于该类型的零值”。int64 的零值就是 0,所以业务上合法的 0 被判成空;指针的零值是 nil,显式传 0 时指针不为空,校验通过,不传才是 nil。
Gin 的 binding:"required" 走的是同一套 validator 规则。本项目文章保存请求里,状态、浏览量、置顶、推荐这几个允许为 0 的字段全部用了指针:
type ArticleSaveReqVO struct {
Title string `json:"title" binding:"required"`
Status *int64 `json:"status" binding:"required"`
ViewCount *int64 `json:"viewCount" binding:"required"`
IsTop *int64 `json:"isTop" binding:"required"`
IsRecommend *int64 `json:"isRecommend" binding:"required"`
}
这样区分了三件事:
| 请求值 | 结构体字段 | 校验结果 | 业务含义 |
|---|---|---|---|
| 字段缺失 | nil | 失败 | 调用方漏传 |
传 0 | 指向 0 的指针 | 通过 | 明确设置为 0 |
传 1 | 指向 1 的指针 | 通过 | 明确设置为 1 |
如果字段本来就可选,不要用 required,用 omitempty 并保留指针。否则“没传”和“传 0”会被合并成同一种结果,后续无论更新还是审计都无法还原调用方的意图。
两个坑连在一起会怎样
更新和校验经常出现在同一条链路上,最容易出现的组合是:
- 请求结构体用
int64加required,前端传 0 被拒绝; - 开发者把校验改成
omitempty,0 能进来了; - 落库时又用
Updates(struct),0 被 GORM 跳过; - 接口返回成功,数据库没有变化。
最后表现为“保存成功但没生效”,排查时只看接口日志很难发现。把每一步的输入输出打出来,或者直接用最小复现对照,比在业务代码里猜更快。
本项目的处理方式是按场景拆开:
- 请求边界用指针区分“缺失”和“零值”;
- 局部更新用 map,明确写出要改的列;
- 整行保存用
Save,但先加载或补齐服务端管理的字段; - 对
master这类开关,服务层显式继承旧值,不依赖 GORM 的零值规则。
可复现的最小验证
不需要改业务表,用临时表就能验证 GORM 的行为。核心代码:
db.Exec("CREATE TEMPORARY TABLE repro_zero (id bigint primary key auto_increment, status tinyint not null default 1)")
db.Exec("INSERT INTO repro_zero(status) VALUES (1)")
db.Model(&zeroRow{}).Where("id = ?", 1).Updates(zeroRow{Status: 0})
// 读回来仍是 1
db.Model(&zeroRow{}).Where("id = ?", 1).Updates(map[string]any{"status": 0})
// 读回来是 0
validator 部分不需要数据库:
v := validator.New()
_ = v.Struct(SaveInt{Status: 0}) // 报 required
zero := int64(0)
_ = v.Struct(SavePtr{Status: &zero}) // 通过
_ = v.Struct(SavePtr{Status: nil}) // 报 required
验证时至少看三件事:SQL 里有没有目标列、数据库里的值有没有变、接口是否把校验错误吞掉了。只看接口返回码,会把“没更新”当成“更新成功”。
边界与常见错误
Updates(struct)不是“更新传入字段”,而是“更新传入的非零字段”。字段多、状态多时,优先用 map 或Select明确列。Save是整行覆盖。用之前确认实体里的其他字段来自数据库,而不是来自一个只填了部分字段的请求体。required对数字、布尔、字符串都按零值判断。允许 0 或空字符串的字段,用指针或去掉required。binding:"omitempty"只表示“空值不校验”,不表示“空值不写入”。落库逻辑仍要单独处理。- 审计字段、租户字段、创建时间这类服务端管理的列,更新时用
Omit排除,不要指望请求体不传就不会被覆盖。
相关工具
需要先确认请求 JSON 的结构和必填字段,可以用 JSON Schema 校验工具 对照字段类型与 required 列表;GORM 回调、软删除和多租户的基础用法见 GORM 使用心得,更多服务端排错文章在 后端开发分类。
FAQ
为什么 Updates(map) 能写 0,Updates(struct) 不能?
结构体更新会按字段的零值做过滤,map 更新则把每个键都当成显式指令。GORM 这样设计是为了支持“只改传进来的字段”,代价是无法用结构体表达“把字段改成零值”。
指针字段会不会让前端更麻烦?
前端仍然传普通数字,0 就是 0。指针只存在于 Go 的请求结构体里,用来区分“JSON 里没有这个键”和“键的值为 0”。序列化和接口文档都不需要暴露指针。
Save 和 Updates 应该默认选哪个?
后台表单整行提交、字段齐全时用 Save;状态流转、局部修改、只改一两列时用 Updates(map)。不要把 Save 当成通用更新方法,也不要把 Updates(struct) 用在允许归零的字段上。
validator 的 required 能改成允许 0 吗?
可以去掉 required,或者把字段改成指针后保留 required。前者无法区分“缺失”,后者能区分,推荐后者。不要用 min=0 之类的规则代替,它表达的是范围,不是“必须出现”。
结语:更新和校验的零值规则方向相反,靠记忆很容易混。把“请求是否带了字段”和“数据库是否要写 0”分开建模,两个坑会同时消失。
评论
还没有评论,来说两句吧