当前位置：首页 > 文章列表 > Golang > Go问答 > Go 判断 JSON 合法却仍解码失败怎么办

Go 判断 JSON 合法却仍解码失败怎么办

来源：17golang原创 2026-10-17 19:00:32 0浏览收藏

遇到“JSON 明明合法，Go 还是解码失败”，先不要继续修改 JSON 文本。json.Valid 只回答“这段字节是不是合法 JSON”，而 json.Unmarshal 还要检查目标参数是不是可写指针、字段类型能不能接收，以及自定义解码逻辑是否返回错误。排查时把这三层分开，通常很快就能定位。

要点速览

json.Valid 通过，不代表目标结构体可以接收这段数据。
优先区分 SyntaxError、UnmarshalTypeError 和 InvalidUnmarshalError。
生产代码可用 RawMessage 保留原片段，用严格解码器尽早暴露未知字段。

先把 JSON 合法性和目标类型分开

下面这段数据在语法上是合法的，但 count 是字符串。如果结构体把它声明为 int，解码阶段仍会返回类型错误：

package main

import (
    "encoding/json"
    "fmt"
)

type Payload struct {
    Count int `json:"count"`
}

func main() {
    data := []byte(`{"count":"12"}`)
    fmt.Println(json.Valid(data)) // 只检查 JSON 语法，结果为 true

    var dst Payload
    err := json.Unmarshal(data, &dst) // 目标字段类型仍需匹配
    fmt.Printf("value=%+v, err=%v\n", dst, err)
}

Valid 通过只说明括号、引号、逗号和字面量符合 JSON 编码；它不会替你检查业务字段的类型、必填关系或取值范围。若输入来自 HTTP 请求，还要确认传入的是完整请求体，而不是已经被截断、拼接或重复读取后的空字节。

Go json.Valid 与 json.Unmarshal 在语法检查和目标类型之间的边界结构说明图 — 图1：结构说明图，区分 JSON 字节、语法检查、目标结构体和类型匹配边界。

按错误类型定位解码失败

不要只打印 err.Error()。标准库提供了可判断的错误类型，先分类再处理会比字符串匹配稳定：

var dst Payload
err := json.Unmarshal(data, &dst)
if err != nil {
    var typeErr *json.UnmarshalTypeError
    var syntaxErr *json.SyntaxError
    switch {
    case errors.As(err, &typeErr):
        // Value、Type 和 Field 可帮助定位字段类型不匹配
        fmt.Printf("字段=%s，输入=%s，目标=%s，偏移=%d\n", typeErr.Field, typeErr.Value, typeErr.Type, typeErr.Offset)
    case errors.As(err, &syntaxErr):
        // Offset 表示语法错误附近的字节位置
        fmt.Printf("JSON 语法错误，偏移=%d\n", syntaxErr.Offset)
    default:
        // 还要覆盖目标参数非法或自定义 UnmarshalJSON 返回的错误
        fmt.Printf("其他解码错误：%v\n", err)
    }
}

如果错误是 json: Unmarshal(non-pointer ...)，检查是否误传了结构体值而不是指针；如果是 cannot unmarshal string into Go struct field ... of type int，修复输入契约或调整字段类型，不要用 json.Valid 掩盖问题。需要保留多态字段时，可以先把字段声明为 json.RawMessage，等识别类型后再进行第二次解码。

Go UnmarshalTypeError SyntaxError 与 InvalidUnmarshalError 的定位关系结构说明图 — 图2：关系说明图，展示不同错误类型与字段、偏移量、目标参数之间的定位关系。

用 RawMessage 和严格字段策略收敛边界

当接口允许一个字段出现多种形态时，RawMessage 能把“整体 JSON 合法”与“分支结构是否匹配”拆开。它适合记录原始片段、延迟判断，或针对不同版本选择不同结构体。

type Envelope struct {
    Kind string          `json:"kind"`
    Data json.RawMessage `json:"data"`
}

// DisallowUnknownFields 让拼写错误的字段尽早暴露，而不是静默丢弃。
decoder := json.NewDecoder(bytes.NewReader(data))
decoder.DisallowUnknownFields()
var env Envelope
if err := decoder.Decode(&env); err != nil {
    // 记录请求编号和错误类型，但不要把完整敏感请求体写入日志
    return fmt.Errorf("decode envelope: %w", err)
}

这类严格策略要和接口兼容性一起评估：新增字段的上游如果本来就允许扩展，直接拒绝未知字段可能造成旧客户端不兼容。比较稳妥的做法是先在灰度环境开启，确认调用方字段集合后再收紧。