结构化输出必填字段缺一个报 400 schema 到底卡在哪层

订单抽取用 gpt-4o-mini 的 json_schema 严格模式,跑了三天稳定,加了个 items 字段之后开始报 400:Invalid schema for response_format 'order': In context=(), 'required' is required to be supplied and to be an array including every key in properties. Missing 'items'.

第一反应是模型不听话,给字段加了三次重试,结果每次都是同样的 400,请求根本没进到推理。这个错是 schema 校验阶段抛的,跟模型输出没关系。回去看 Pydantic 生成的 schema,items 定义成 list 且给了 default=[],于是它没被放进 required 数组。

严格模式的要求是全字段必填,且 additionalProperties 为 false。有默认值的字段会被判成可选,这就是缺一个的根因。试过把 default 改成 None 加 Optional,schema 里变成了 anyOf 带 null,接口直接拒绝,因为严格模式不支持联合类型里的 null 分支。

改法是模型层不写默认值。所有字段声明为必填,空列表就让模型输出 [],业务侧拿到空数组自己处理。additionalProperties 显式设 false,嵌套对象展开写,不要留 $ref 让服务端去解。

schema = Model.model_json_schema()
schema["additionalProperties"] = False
schema["required"] = list(schema["properties"].keys())

jsonschema.validate(sample, schema,
                    cls=jsonschema.Draft202012Validator)
print(schema["required"])

判断修好不看 400 有没有消失,要看到字段真的回来了。跑 500 条真实工单,0 次 400,items 字段缺失率 0,空数组占比 6.4%,和人工标注的空值比例对得上。另外加了一条本地校验,请求前先用 Draft202012Validator 过一遍 schema,报错在发请求之前就能拦下。

您可以还会对下面的文章感兴趣: