Golang如何处理JSON请求与响应_JSON解析与输出技巧

Go中json.Unmarshal静默失败主因是字段未导出或JSON key不匹配且无json tag；HTTP中需校验Content-Type、限流读取并用json.NewDecoder安全解析。

Go 中 json.Unmarshal 为什么会静默失败？

常见现象是结构体字段没被赋值，但错误返回为 nil。根本原因通常是字段未导出（首字母小写）或 JSON key 与字段名不匹配且没加 json tag。

• Go 的 json 包只能序列化/反序列化**导出字段**（即首字母大写）
• 默认按字段名首字母大写后匹配 JSON key（如 UserName → "username" 不会自动匹配，除非加 tag）
• 若 JSON 中有字段缺失，对应字段保持零值，不会报错；只有语法错误或类型强冲突才返回 error

type User struct {
    ID    int    `json:"id"`
    Name  string `json:"name"`
    Email string `json:"email,omitempty"` // 空字符串时省略该字段
}

HTTP handler 里怎么安全读取 JSON 请求体？

别直接用 io.ReadAll(r.Body) 后反复解析 —— r.Body 是单次读取流，第二次读就为空。更关键的是，要提前检查 Content-Type，并限制请求体大小，防止内存耗尽。

• 用 r.Header.Get("Content-Type") 判断是否为 "application/json"
• 用 http.MaxBytesReader 包裹 r.Body，例如限制最大 1MB：http.MaxBytesReader(w, r.Body, 1024*1024)
• 解析前先校验长度，避免空 body 导致 json.Unmarshal 成功但字段全零值

func handleUser(w http.ResponseWriter, r *http.Request) {
    if r.Method != "POST" {
        http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
        return
    }
    if r.Header.Get("Content-Type") != "application/json" {
        http.Error(w, "Content-Type must be application/json", http.StatusBadRequest)
        return
    }

    body := http.MaxBytesReader(w, r.Body, 1024*1024)
    defer r.Body.Close()

    var u User
    if err := json.NewDecoder(body).Decode(&u); err != nil {
        http.Error(w, "Invalid JSON", http.StatusBadRequest)
        return
    }
    // ... 处理逻辑
}

如何让 json.Marshal 输出可读格式并控制 NaN/Infinity？

json.Marshal 默认输出紧凑 JSON，且对 float64 的 NaN 或 +Inf 会直接 panic。生产环境必须处理这两点。

MuleRun

全球首个AI Agent交易平台

下载

• 用 json.MarshalIndent 替代 json.Marshal，传入缩进参数（如 " "）获得格式化输出
• 对含浮点字段的结构体，应在编码前检查：用 math.IsNaN / math.IsInf 预处理，或自定义 MarshalJSON 方法
• 注意 time.Time 默认序列化为 RFC3339 字符串，无需额外处理；但若需 Unix 时间戳，得重写 MarshalJSON

func (u User) MarshalJSON() ([]byte, error) {
    type Alias User // 防止无限递归
    if math.IsNaN(float64(u.ID)) || math.IsInf(float64(u.ID), 0) {
        return json.Marshal(&struct {
            ID    interface{} `json:"id"`
            Name  string      `json:"name"`
            Email string      `json:"email"`
        }{ID: nil, Name: u.Name, Email: u.Email})
    }
    return json.Marshal(&Alias(u))
}

嵌套结构、空数组、null 值怎么区分处理？

Go 的 json 包把 JSON null 映射为 Go 的零值（如 "", 0, nil），无法区分「字段不存在」「字段为 null」「字段为零值」。需要指针或自定义类型。

立即学习“go语言免费学习笔记（深入）”；

• 对可能为 null 的字段，用指针类型（如 *string, *int），null 解析为 nil，空字符串为 &""
• 对切片，JSON null 和空数组 [] 都解析为 nil；若需区分，用包装类型实现 UnmarshalJSON
• 避免用 interface{} 接收任意 JSON，它会导致运行时类型断言频繁且易 panic

type Payload struct {
    Name  *string   `json:"name"`
    Tags  []string  `json:"tags"` // null 和 [] 都变成 nil；如需区分，改用 *[]string 或自定义类型
    Extra *json.RawMessage `json:"extra"` // 延迟解析，保留原始字节
}