共计 1496 个字符，预计需要花费 4 分钟才能阅读完成。
Claude 处理复杂 JSON 易出错，需五步应对：一、预填充“{”强制结构对齐；二、两阶段校验修复；三、嵌入 Schema 规则并设唯一出口；四、客户端截取花括号间内容；五、Kotlin 端用 kotlinx.serialization 加运行时校验。
当 claude 处理包含嵌套对象、数组、枚举约束、字段互斥或长度限制的复杂 json 格式时，可能出现解析失败、字段遗漏、类型错配或结构不闭合等问题。以下是验证与应对该类问题的具体操作路径：
一、启用预填充响应法强制结构对齐
该方法通过在 assistant 角色消息中预置左花括号“{”，使模型从第一字符即进入 JSON 生成状态，规避解释性前缀干扰，显著提升嵌套层级与键名一致性。
1、在 API 调用的 messages 数组中，将 assistant 角色的 content 设为“{”。
2、确保 user 角色提示词中已明确定义 schema 及全部校验规则，不含模糊表述。
3、接收响应后，截取从第一个“{”到最后一个“}”之间的完整字符串。
4、使用 JSON 解析器尝试加载该字符串；若失败，则进入第二轮修复流程。
二、实施两阶段校验与修复回路
该方法将生成过程拆分为草稿输出与自检重构两个独立阶段，利用模型自身能力识别并修正格式缺陷，适用于含互斥字段、条件必填或深度嵌套的 schema。
1、第一轮请求中，要求模型输出“草稿 JSON”，允许存在字段缺失或类型偏差。
2、将草稿 JSON 原文作为第二轮输入，并附加严格校验指令。
3、第二轮指令必须声明：仅输出最终 JSON，不得添加任何解释、Markdown 或额外文本。
4、在第二轮指令中逐条列出必须满足的规则，例如“priority 字段值只能是 low/medium/high”“tags 数组长度不得超过 5”。
三、嵌入 Schema 校验规则并设定唯一出口
该方法通过显式声明字段约束与失败响应格式，将模型的“自由发挥”引导至可控结构内，避免因理解偏差导致的格式漂移。
1、在提示词开头明确声明：“你必须只输出 JSON（不要 Markdown，不要解释）”。
2、列出所有必需字段名称，并标注其数据类型与可选值范围。
Axiom 是一个浏览器扩展，用于自动化重复任务和 web 抓取。
3、对字符串字段注明最大长度，对数组字段注明最小 / 最大元素数量。
4、强制规定：若无法满足任一规则，则只输出 {“error”: “ 原因 ”, “need”: [“ 缺少的信息 ”] }。
四、客户端侧轻量净化与截取策略
该方法在接收响应后，由客户端主动剥离非 JSON 内容，降低服务端输出不稳定带来的影响，属于防御性兜底手段。
1、扫描响应全文，定位第一个出现的“{”字符位置。
2、从该位置开始向后查找，定位最后一个匹配的“}”字符位置。
3、提取该区间内的子字符串，作为待解析 JSON 主体。
4、若未找到成对的花括号，或提取后仍解析失败，则触发错误上报流程。
五、Kotlin 端集成 kotlinx.serialization 与运行时校验
该方法在反序列化阶段引入强类型校验与兜底字段支持，使程序能安全接收含 error/need 字段的降级响应，避免崩溃。
1、定义数据类 Ticket，包含 intent、priority、summary、tags 等主字段，同时声明 error 与 need 为可空字段。
2、使用 @Serializable 注解标记类，并为 priority 定义枚举类 Priority，绑定 SerialName。
3、初始化 Json 实例时启用 strictMode = false，并配置 ignoreUnknownKeys = true。
4、解析完成后检查 error 字段是否非空；若非空，则依据 need 字段发起补充请求。
