使用santhosh-tekuri/jsonschema验证序列化结构体时遇JSON格式错误求助

这个 panic 错误本质是你传入的 []byte 数据不是合法的单个 JSON 顶层值——简单说就是序列化后的结构体 JSON 格式出问题了，比如出现了多个根对象（比如 {"a":1}{"b":2} 这种连在一起的情况），或者序列化过程中生成了语法错误的 JSON。

我给你梳理几个排查和解决的步骤：

1. 先确认序列化后的 JSON 内容是否合法 #

先把你的 []byte 转成字符串打印出来，直接看内容是不是符合 JSON 规范：

fmt.Println(string(yourStructBytes))

重点检查：

• 是不是只有一个根对象/数组（不能有多个 {} 或 [] 连在一起）
• 有没有语法错误：比如引号不匹配、多余的逗号、缺失的括号等

2. 排查结构体序列化的过程 #

如果你用的是 Go 标准库 encoding/json 序列化结构体，要注意两个关键点：

• 结构体字段必须是首字母大写的导出字段，否则序列化时会被忽略，可能生成空 JSON 或者不符合预期的内容
• 如果自定义了 MarshalJSON 方法，一定要确保它返回的是单个有效的 JSON 值，不能拼接多个 JSON 对象

举个正确的序列化示例：

type User struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
}

// 正确的序列化流程
user := User{Name: "Alice", Age: 30}
jsonBytes, err := json.Marshal(&user)
if err != nil {
    // 一定要处理序列化错误，不要忽略！
    log.Fatalf("marshal struct failed: %v", err)
}

3. 规范使用 jsonschema 库的验证流程 #

使用 santhosh-tekuri/jsonschema 时，不要直接把未解析的 []byte 丢给验证方法（部分场景下会触发 panic），建议先自己用 json.Unmarshal 解析一次，提前捕获 JSON 格式错误：

import (
    "encoding/json"
    "log"

    "github.com/santhosh-tekuri/jsonschema/v5"
)

// 加载 JSON Schema
schema, err := jsonschema.Compile("path/to/your/schema.json")
if err != nil {
    log.Fatalf("compile schema failed: %v", err)
}

// 先解析序列化后的结构体 JSON
var jsonData interface{}
err = json.Unmarshal(yourStructBytes, &jsonData)
if err != nil {
    // 这里就能提前捕获 JSON 格式错误，避免 panic
    log.Printf("invalid JSON data: %v", err)
    return
}

// 执行验证
err = schema.Validate(jsonData)
if err != nil {
    log.Printf("validation failed: %v", err)
    return
}

4. 排查是否存在多次序列化的问题 #

这个是很容易踩的坑：比如你不小心把已经序列化后的 []byte 又当成普通结构体再序列化了一次，会生成类似 "{"name":"Alice"}" 这样的带引号的字符串，或者多次序列化拼接出多个 JSON 对象，都会触发这个错误。一定要确保你的代码中只对结构体做一次序列化操作。

内容的提问来源于stack exchange，提问作者cafej