硅基流动 JSON 少字段：从 Schema 到业务必填项的验证

硅基流动 JSON 少字段时，先区分语法、结构和业务必填三个层次。能被 json.loads 读取，只证明语法可解析；符合结构，也不自动证明值来自原文。本文交付一组本地合成验收样本，不重复接口的结构化输出参数表。

先把缺失的含义约定清楚

假设要从订单文本提取编号、金额和币种。编号必须逐字保留，金额用十进制字符串，币种只接受约定枚举。原文没有金额时，究竟允许 null，还是应将记录送人工复核，要由业务先决定。不要让解析器擅自把缺失金额填零，零本身可能是有效业务值。

合成输入结果	语法	结构	业务
{"id":"0007","amount":"12.30","currency":"CNY"}	通过	通过	与原文核对
{"id":"0007","amount":"12.30"}	通过	缺币种	拒收或人工
{"id":"0007","amount":12.3,"currency":"CNY"}	通过	金额类型错	不静默转换
{"id":"0007","amount":"0","currency":"CNY"}	通过	可能通过	若原文12.30则失败

金额字符串是示例合同，不代表平台要求。选择字符串有助于保留小数表达，最终计算仍应用十进制定点规则。若项目已有金额类型，优先遵守该合同。

结构校验保留清晰错误路径

Schema 或数据模型应明确必需键、类型、枚举与额外字段策略。失败记录写字段路径，例如 records[2].currency，并区分“键不存在”与“显式空值”。同一请求返回多条记录时，部分记录失败不能让整个结果悄悄丢行；需要有效、隔离和无法解析三类去向。

import json
from decimal import Decimal, InvalidOperation

def check(raw):
    obj = json.loads(raw)
    for key in ('id', 'amount', 'currency'):
        if key not in obj:
            raise ValueError('缺字段: ' + key)
    if not isinstance(obj['id'], str) or not obj['id']:
        raise ValueError('编号必须是非空文本')
    if not isinstance(obj['amount'], str):
        raise ValueError('金额必须是字符串')
    try:
        amount = Decimal(obj['amount'])
    except InvalidOperation as exc:
        raise ValueError('金额不可解析') from exc
    if not amount.is_finite():
        raise ValueError('金额必须有限')
    if obj['currency'] not in {'CNY', 'USD'}:
        raise ValueError('未知币种')
    return obj

这个短函数是最小示例，尚未约束小数位、金额上限和额外字段；正式系统需补自己的业务规则。它不会访问 API，也不会证明模型输出准确。

业务断言回到输入证据

对每条结果保留输入编号与原始片段。确认编号有没有去掉前导零、币种有没有根据语言猜测、金额单位有没有遗漏。缺失字段可以触发有限次数的定向补提取，但补提取仍需原文证据；不能只把失败 JSON 交回模型让它“补齐”，否则容易补出看似合理的值。

为每个失败原因设一个可数分类：解析失败、缺必需键、类型错误、原文不支持。发布前用固定样本比较各类数量，而不是只看总成功率。若修改 Schema 后通过率变高，检查是不是放宽了规则导致错误被接受。

再加入两条会被简单类型检查漏掉的反例：编号从0007变成0008，币种从CNY变成USD。两者类型和枚举都可能合法，但与原文不符，应在第三层失败。还可以让输入没有币种，看程序是否擅自填入默认币种；如果业务确有默认值，结果要注明规则补充，不能把它写成原文提取。批量报告同时保存有效数、隔离数和失败原因，确保缺字段记录没有因异常被直接跳过。最终验收时挑一条隔离记录沿原始输入回查，证明它仍可定位和重新处理。

常见问题

提示词写“必须返回全部字段”够吗？ 不够，仍需程序校验与缺失处理。

缺金额直接填零可以吗？ 只有业务合同明确允许且能区别“未提供”和“真实为零”时才考虑。

字段齐全可以跳过原文核对吗？ 不可以，结构验证不判断事实是否成立。

继续处理相关问题

相关入口：硅基流动接入基础。

官方依据与核对日期

核对日：2026-10-23。硅基流动接口结构：接口参数与返回结构需要按当前文档和模型支持核对；Python JSON：JSON 解码负责语法转换，不提供业务字段完整性保证。文中的流程、阈值和合成数据属于工程示例，不能代替当前账号、文件或运行环境的验收。