Go json.Valid 怎样只检查 JSON 语法而不解析数据

如果程序只想先知道一段字节是不是合法 JSON，直接调用 json.Valid([]byte(data)) 就够了。它只回答“这段数据是否符合 JSON 编码”，返回 true 或 false，不会把字段映射成 Go 结构体。

官方地址：https://pkg.go.dev/encoding/json#Valid

json.Valid 适合做语法预检；一旦要使用字段、检查类型或执行业务规则，仍然要继续 Unmarshal。

现场：只想知道输入是不是合法 JSON

常见场景是网关、消息接收器或原文落库入口拿到一段 []byte：此时还不确定它是不是 JSON，也不想为了预检先设计一个目标结构体。问题可以拆成两层：第一层是括号、引号、逗号等 JSON 语法是否成立；第二层才是字段能否映射到某个 Go 类型。

这两层不要混在一起。第一层使用 json.Valid，第二层使用 json.Unmarshal 或 json.Decoder。

json.Valid 到底判断了什么

官方定义是：判断 data 是否为有效的 JSON 编码。它接收字节切片，结果只有布尔值，适合在输入边界做一个轻量分流。

package main

import (
    "encoding/json"
    "fmt"
)

func main() {
    good := []byte(`{"name":"gopher","count":2}`)
    bad := []byte(`{"name":"gopher",}`)

    // 这里只预检 JSON 语法，不创建目标 Go 结构体。
    fmt.Println(json.Valid(good))
    fmt.Println(json.Valid(bad))
}

这个例子里，前一段会得到 true，后一段会得到 false。注意返回值不携带错误位置，因此它适合“接受还是拒绝”的判断，不适合直接展示“第几列少了逗号”这样的诊断。

为什么 true 之后仍然要 Unmarshal

JSON 语法有效，只代表文本能够被当作 JSON 读取，并不代表它符合你的结构体。比如 {"count":"2"} 可能是有效 JSON，但把 count 解到 int 字段时，类型映射仍可能失败。

package main

import (
    "encoding/json"
    "fmt"
)

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

func decode(data []byte) error {
    // 先挡住明显的 JSON 语法问题，再进入结构化解码。
    if !json.Valid(data) {
        return fmt.Errorf("invalid JSON syntax")
    }

    var payload Payload
    // Valid 不检查字段类型，所以这里仍必须处理 Unmarshal 的错误。
    if err := json.Unmarshal(data, &payload); err != nil {
        return fmt.Errorf("decode payload: %w", err)
    }
    fmt.Println(payload.Count)
    return nil
}

因此，Valid 和 Unmarshal 不是二选一的替代品：前者回答“文本像不像 JSON”，后者回答“能不能装进这个 Go 值”。如果入口已经要立刻解码，通常直接检查 Unmarshal 返回的错误即可；只有在预检和后续处理确实分离时，单独调用 Valid 才有价值。

把预检放在输入边界

可以把预检放在保存原文、转发或异步入队之前。这样做的重点不是增加一层“安全感”，而是把处理分支写清楚：语法无效的数据直接拒绝或记录；语法有效的数据继续进入类型解码；解码成功后再执行字段范围和业务规则检查。

这里不要把 true 写成“数据可信”。它没有验证字段是否存在、数值是否在业务范围内，也没有保证目标结构体一定能接收这些字段。需要更详细的错误位置时，应让后续解码器返回错误，或在业务层补充定位信息。

常见误区与结论

• 误区一：把 json.Valid 当成反序列化。它不填充结构体，也不做字段类型转换。
• 误区二：认为 true 代表业务数据正确。字段缺失、类型不匹配和范围错误仍要单独处理。
• 误区三：需要详细语法错误时只保留布尔值。此时应保留原始输入并让解码阶段产生可记录的错误。

一句话总结：只检查 JSON 语法，用 json.Valid；要得到 Go 值，用 json.Unmarshal 或 json.Decoder；要判断业务可用，还需要独立的字段与规则检查。

常见问题

json.Valid 能检查字段是否存在吗？

不能。它只判断 JSON 编码是否有效，字段存在性属于结构或业务层检查。

已经要 Unmarshal，还需要先调用 json.Valid 吗？

不一定。如果解码是紧接着发生的，直接处理 Unmarshal 的错误通常更简单；只有需要在解码前单独分流时，预检才更合适。