json: unknown field "summary" Request id: 0217889602287285f505d6745d4b07a5efbd0d...

🔍 报错分析

1. 🌐 错误翻译

原文：json: unknown field "summary"
译文：JSON：未知字段 "summary"

2. 🎯 原因分析

该错误表明在解析 JSON 数据时，遇到了一个未在目标数据结构中定义的字段 "summary"。根本原因是 JSON 数据中包含目标结构未预期的额外字段，而解码目标（通常是结构体）未包含该字段，导致 JSON 反序列化失败。

错误通常发生在将 JSON 解析为 Go 结构体等强类型语言的数据结构时，目标类型未定义 summary 字段，且解析器默认配置为不允许未定义字段。

3. 💡 解决方案

根据目标数据结构所支持的序列化库，提供以下两种常见修复方案：

#### 方案一：Go 语言（struct 解析）
为目标结构体添加 summary 字段，或使用 json:"-" 忽略该字段，同时允许额外字段通过 json:",omitempty" 或解码配置处理。

type YourStruct struct {
    // 原有字段...
    Summary string `json:"summary,omitempty"` // 添加对应字段，兼容额外字段
    // 其他字段...
}

#### 方案二：允许忽略未知字段（以 Go 为例，若确认该字段无需使用）
若无需使用 summary 字段，可通过配置解码器忽略未知字段，或为目标结构体添加该字段但不参与业务逻辑。

// 在解析时允许忽略未知字段（Go 中需调整 JSON 解码配置，或用 map 接收后过滤）
var data map[string]interface{}
if err := json.Unmarshal(jsonData, &data); err == nil {
    // 手动提取需要的结构，忽略未知字段
}

#### 方案三：其他语言（如 Python、Java）

Python：使用 json.loads() 时默认忽略未知字段，若用 dataclass 可通过 field(metadata={"metadata": True}) 配置，或直接用 dict 接收。

Java：使用 Jackson 时，通过 @JsonIgnoreProperties(ignoreUnknown = true) 注解在类上标记，允许忽略未知字段。

4. 🛡️ 预防措施

字段校验前置：对接接口前明确数据契约，定义完整的字段映射，避免因字段缺失或多余导致解析失败，可使用 JSON Schema 校验工具。

兼容配置：明确是否需要严格解析未知字段，合理配置序列化/反序列化工具的未知字段处理策略（如允许忽略或严格校验），减少硬编码字段依赖。