Golang区分JSON null与零值技巧

在Go语言中处理JSON的null值时，原生类型（如string）无法区分JSON中的null与空字符串""，因为json.Unmarshal会将null统一替换为对应类型的零值（如""），导致业务语义丢失；唯有改用*string等指针类型才能准确映射：null→nil、""→指向空字符串的指针、"abc"→指向"abc"的指针——但随之而来的是解引用前必须显式判空以防panic、序列化时omitempty无法同时忽略nil和零值、数据库NULL与API层指针对齐困难等一系列连锁挑战，真正棘手的并非语法细节，而是如何在整个数据流转链路（HTTP请求→内存模型→DB存储→日志输出）中一致、安全、无损地保全“未设置”与“明确为空”的语义差异。

JSON字段为null时，string类型字段解码后是空字符串还是nil？

不是空字符串，也不是nil——Go 的 json.Unmarshal 对原生类型（如 string、int、bool）根本无法表示“缺失”或“null”，它只会用对应类型的零值填充。比如 JSON 中 "name": null 解到 type User struct { Name string }，Name 会是 ""，完全无法区分是前端传了 null，还是传了空字符串 ""。

实操建议：

• 需要区分 null 和空值的字段，必须改用指针类型，例如 *string、*int64
• 指针解码后：null → nil；"" → 指向空字符串的指针；"abc" → 指向 "abc" 的指针
• 注意：指针字段在结构体初始化时默认就是 nil，所以解码前无法靠初始值判断是否被设置过

用*string解码后怎么安全取值？别直接解引用

直接写 user.Name != nil && *user.Name == "xxx" 看似没问题，但一旦 user.Name 是 nil，*user.Name 就 panic。这不是理论风险，是线上高频崩溃点。

实操建议：

• 永远先判空再解引用：if user.Name != nil { name := *user.Name }
• 封装一个安全取值函数，避免重复写判空逻辑：

  func DerefString(p *string) string {
      if p == nil {
          return ""
      }
      return *p
  }

• 如果业务上 null 和空字符串语义不同（比如“未填写”vs“明确填了空”），就不能用 DerefString 合并处理，得保留 nil 判断分支

想让omitempty同时忽略零值和nil指针？不行，得手动控制

json:",omitempty" 对指针类型只忽略 nil，不忽略非-nil但指向零值的情况（比如 *string 指向 ""）。这意味着：你想序列化时把 "" 和 nil 都去掉，光靠 tag 不行。

实操建议：

• 不要依赖 omitempty 处理“业务意义上的空”，它只做字面意义的零值/nil过滤
• 需要统一过滤时，要么提前清理结构体（比如遍历字段，把 *string 指向 "" 的设为 nil），要么用自定义 MarshalJSON 方法
• 注意：自定义 MarshalJSON 会绕过标准 marshal 流程，如果结构体嵌套深，容易漏字段或引发循环引用

数据库字段允许NULL，但API返回要转成指针——中间层怎么对齐？

常见场景：PostgreSQL 的 name TEXT NULL 映射到 Go 结构体，ORM（如 GORM、sqlx）通常支持扫描到 *string，但如果你用的是 sql.Scan 或原生 Rows.Scan，它不自动处理 NULL，直接扫会 panic。

实操建议：

• 用 sql.NullString 等标准 sql.Null* 类型接收，再手动转成 *string（if ns.Valid { s = &ns.String }）
• GORM v2 默认支持 *string，但要注意：如果字段在 DB 中是 NOT NULL，GORM 仍可能把空字符串扫成非-nil指针，和 JSON 行为不一致
• 最稳的方式：所有涉及“可空+需区分null”的字段，在领域模型里统一用指针；在 DB 层/HTTP 层做显式转换，不依赖框架隐式行为

真正麻烦的不是语法怎么写，而是同一个字段在 JSON 请求、DB 存储、内存模型、日志输出里，到底该以什么形态存在——稍不注意，nil 在某一层被悄悄转成 ""，后面就再也分不清是用户没填，还是填了个空。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang区分JSON null与零值技巧》文章吧，也可关注golang学习网公众号了解相关技术文章。