结构化输出失败怎么办：解析、修复和降级路径

结构化输出能显著降低解析风险，但生产系统仍然要准备失败路径。OpenAI Structured Outputs 文档说明可以用 schema 约束模型输出，工具文档也强调机器可读参数的重要性。[parse-001][parse-002]

失败要分类型

常见失败包括：

• JSON 不可解析。
• 字段缺失。
• 枚举值非法。
• 内容与业务规则冲突。
• 置信度过低。

结构化输出不是免检通行证，schema 校验只是第一道门。

概念处理：

{
  "schema_valid": false,
  "error": "missing required field: decision",
  "next_action": "repair_once"
}

修复只能重试有限次

可以把原始输出和校验错误发给模型修复一次，但不要无限循环。连续失败应降级到人工复核或返回安全错误。

实践建议：

1. 严格 schema 校验。
2. 修复请求最多一次或两次。
3. 记录失败样本进入评估集。
4. 高风险任务不要自动猜字段。

综合结构化输出资料可以推断：可靠性来自“生成 + 校验 + 修复 + 降级”的闭环，而不是只依赖模型第一次输出。

参考资料

1. [parse-001] OpenAI Developers, “Structured Outputs”, https://developers.openai.com/api/docs/guides/structured-outputs
2. [parse-002] OpenAI Developers, “Tools”, https://developers.openai.com/api/docs/guides/tools