如何使用Golang encoding json解析数据_JSON序列化反序列化流程

json.Unmarshal返回nil错误但数据为空，根本原因是字段未导出或json标签不匹配；需确保首字母大写、标签一致，并用*string等处理null，用json.RawMessage或interface{}应对类型不一致，用json.Encoder.SetEscapeHTML(false)避免中文转义。

json.Unmarshal 解析 JSON 字符串时为什么返回 nil 错误却数据为空？

常见现象是 json.Unmarshal 返回 nil，但结构体字段全是零值（0、""、nil），实际 JSON 数据明明有内容。根本原因通常是字段未导出（首字母小写）或标签不匹配。

• Go 的 encoding/json 只能序列化/反序列化**导出字段**（首字母大写）
• 如果 JSON key 是 "user_name"，而结构体字段是 UserName string，必须加 json:"user_name" 标签，否则无法映射
• 嵌套 JSON 中若存在 null 值，对应字段类型不能是基础类型（如 string），需改用指针（*string）或 sql.NullString 类型

type User struct {
    ID       int    `json:"id"`
    UserName string `json:"user_name"` // 必须显式声明，否则忽略
    Email    *string `json:"email"`    // 支持 null
}

如何安全处理可能缺失或类型不一致的 JSON 字段？

API 返回字段不稳定（比如某次返回 "age": 25，另一次是 "age": "25"），直接绑定到 int 会 panic。不能依赖“数据一定规范”，得做防御性解析。

• 用 json.RawMessage 延迟解析：先解到一个中间字段，再按需转成 int、string 或其他类型
• 对易变字段，定义为 interface{}，再用类型断言 + fmt.Sprintf 或 strconv 转换
• 避免在 Unmarshal 时直接绑定到强类型字段，尤其来自第三方 API 的响应

type Response struct {
    Data json.RawMessage `json:"data"`
}
// 后续：json.Unmarshal(data, &target) 或 json.Unmarshal(data, &strVal)

json.Marshal 输出中文变成 \uXXXX 怎么办？

默认 json.Marshal 会将非 ASCII 字符（如中文）转义为 Unicode 码点，结果像 "\u4f60\u597d"。这不是错误，而是标准行为；但日志、调试或前端直读时体验差。

• 用 json.MarshalIndent 不解决转义问题
• 正确方式是使用 json.Encoder 并调用其 SetEscapeHTML(false) 方法（注意：该方法实际也禁用 Unicode 转义）
• 更简单的是直接替换：`bytes.ReplaceAll(marshaled, []byte("\\u"), []byte("u"))` 不推荐——破坏 JSON 合法性；应走 Encoder 路线

var buf bytes.Buffer
enc := json.NewEncoder(&buf)
enc.SetEscapeHTML(false) // 关键：禁用 Unicode 和 HTML 转义
enc.Encode(user)

为什么嵌套结构体反序列化失败却没报错？

例如外层 JSON 有 "profile": {"name": "Alice"}，但 Profile 字段类型写成 Profile string（而非 Profile struct{...}），Unmarshal 仍返回 nil 错误，只是静默跳过该字段。

• Go 的 JSON 包在类型不匹配时倾向于“忽略”而非报错，尤其当目标字段是空接口、字符串或基础类型时
• 务必检查结构体字段类型是否与 JSON 实际结构严格一致（对象 → struct，数组 → slice，数字 → number 类型）
• 开启严格模式：用 json.Decoder 替代 json.Unmarshal，并设置 DisallowUnknownFields() 捕获多余字段，间接暴露结构偏差

dec := jso
n.NewDecoder(strings.NewReader(jsonStr))
dec.DisallowUnknownFields() // 遇到 struct 中没有定义的 key 就报错
err := dec.Decode(&user)

关键点在于：Go 的 JSON 包设计偏“宽容”，不报错不等于数据正确；真正容易被忽略的是字段导出性、标签一致性、以及嵌套层级的类型精确匹配——这些地方一错，数据就丢得无声无息。