Go json.Unmarshal 为什么把 null 写进指针后变成 nil

我在排查一个接口入参时，看到 json.Unmarshal 执行没有报错，但结构体里的 *string 字段突然变成了 nil。这不是 Go 丢数据，而是 JSON 的 null 对指针字段的明确语义：解码器会把指针设为 nil；如果输入不是 null，才会继续把内容写入指针指向的值。

只要 JSON 字段值是 null，目标字段是指针、map、slice 或 interface，encoding/json 就会把它设为 nil。普通 string、数字等非指针类型收到 null 时不会报错，也不会覆盖原值。

• 指针字段：null 会清空指针，结果是 nil。
• 非指针字段：null 通常对原值没有影响。
• 缺省字段：没有出现在 JSON 中时，目标字段同样保持原状。

先用一个结构体还原现场

下面把指针字段预先指向旧值，再让 JSON 同时传入 null、普通值和没有出现的字段。代码中的注释只解释关键观察点，方便把结果和输入逐项对上。

package main

import (
    "encoding/json"
    "fmt"
)

type Request struct {
    Name  *string `json:"name"`
    Age   int     `json:"age"`
    Note  string  `json:"note"`
}

func main() {
    oldName := "旧名字"
    req := Request{Name: &oldName, Age: 20, Note: "旧备注"}

    data := []byte(`{"name":null,"age":21,"note":null}`)
    // null 进入指针字段时会清空指针，普通字段则保留原值。
    if err := json.Unmarshal(data, &req); err != nil {
        fmt.Println("解码失败:", err)
        return
    }

    fmt.Printf("Name nil=%v, Age=%d, Note=%q\n", req.Name == nil, req.Age, req.Note)
}

按这段输入，Name nil=true、Age=21、Note="旧备注"。也就是说，null 并不是把字符串写成某个特殊文本，而是触发了指针字段的清空规则；note 是普通 string，所以原值没有被覆盖。

为什么指针会被设成 nil

encoding/json 的解码规则先判断 JSON 值是不是字面量 null。如果目标是指针，命中后直接把指针设为 nil；只有输入不是 null 时，才会解码到指针指向的对象。如果指针原本就是 nil，而输入是一个对象或字符串，解码器会先分配目标值，再继续写入。

因此，下面两种输入的方向正好相反：{"name":null} 表示把 Name 清空；{"name":"新名字"} 表示让解码器确保有一个 string 对象，并把它写进去。这个行为由输入值和目标类型共同决定，不是 json.Unmarshal 随机回收了对象。

指针字段和普通字段不要混着判断

排查时最容易误判的是把“字段没有值”和“字段被传入 null”当成同一件事。对 *string 来说，字段缺省与显式 null 最终都可能看到 nil；但对已经有旧值的普通 string，显式 null 不会把它改成空字符串，字段缺省也不会改变旧值。

接口建模时怎么避免误判

如果业务需要表达“未提供”和“明确清空”两个不同动作，仅靠一个 *string 不一定能区分：字段缺省和显式 null 都可能得到 nil。此时应在请求层额外记录字段是否出现，或使用自定义解码类型保存“是否出现”和“是否为 null”这两层状态；不要在业务层看到 nil 后直接猜测用户到底传了什么。

如果业务只需要表达“有值/没有值”，*string 反而是直观选择。调试时按三步检查：先打印原始 JSON 是否包含该键，再确认值是 null 还是具体值，最后核对目标字段是不是指针、map、slice 或 interface。这样就能把语义问题和真正的解码错误分开。

Go json.Unmarshal 的常见问题

null 会让 json.Unmarshal 返回错误吗？

对指针、map、slice 和 interface，null 通常会设置为 nil 并返回 nil 错误；对普通类型也通常不报错，只是不改变原值。真正的语法错误或类型不匹配仍可能返回相应错误。

为什么指针字段和字段缺省看起来一样？

因为两者都可能保留 nil。指针本身只能表达“当前有没有对象”，不能单独记录键是否出现在 JSON 中；需要区分更新语义时，要额外保存字段存在状态。

把字段改成 string 能阻止 nil 吗？

可以避免指针变 nil，但会失去“没有值”和“空字符串”的类型区分，而且 null 对 string 不会自动变成空字符串。是否改类型应由接口语义决定，不能只为绕开一次排障现象。

这次现象的核心可以记成一句话：json.Unmarshal 先看 JSON 值，再按目标类型处理；null 遇到指针就设为 nil，遇到普通字段则通常不改原值。沿着“输入值—目标类型—已有状态”三项核对，基本就能解释清楚结果。