本文实现一个不依赖网络的版本适配器,将人工旧协议归一到新协议,并覆盖混合字段和类型错误。
直接回答:字段改名后怎样兼容旧数据?
先为每个版本写清字段和类型,再按明确版本进入对应转换逻辑;未知版本、缺字段和混用新旧字段时拒绝并记录,不能悄悄猜测。下面演示把人工协议 v1 的 answer 转成 v2 的 result。它是本地约定,不代表任何模型厂商的真实响应。
输入、输出和边界
输入是已经解析成 Python 字典的虚构对象:{"version":1,"answer":"你好"} 或 {"version":2,"result":"你好"}。输出是新的 v2 字典,原输入不被修改。这里要求严格字段集合,仅保留非空字符串;业务需要额外字段时应先修改契约与测试,而不是静默丢弃。Python 3.11 标准库即可运行,无密钥、无网络、无模型请求。
生产中还需先在网络边界限制消息大小,验证 JSON 重复键、身份与来源;此示例接收已解析字典,无法发现解析时已被覆盖的重复键。版本迁移不等于验证生成结果的事实正确性或生产安全。
完整实现
保存为 schema_migration.py,执行 python schema_migration.py:
"""人工协议演示:把 v1 和 v2 显式转换为统一结构。"""
import json
def normalize(record):
if not isinstance(record, dict):
raise ValueError('record must be an object')
version = record.get('version')
if type(version) is not int or version not in (1, 2):
raise ValueError('unsupported version')
expected = {'version', 'answer'} if version == 1 else {'version', 'result'}
if set(record) != expected:
raise ValueError('invalid fields')
value = record['answer'] if version == 1 else record['result']
if not isinstance(value, str) or not value.strip():
raise ValueError('result must be nonempty text')
return {'version': 2, 'result': value}
if __name__ == '__main__':
for sample in ({'version': 1, 'answer': '你好'}, {'version': 2, 'result': '你好'}):
print(json.dumps(normalize(sample), ensure_ascii=False))
本次运行结果:
{"version": 2, "result": "你好"}
{"version": 2, "result": "你好"}
版本使用 type(version) is int,避免 Python 中布尔值作为整数子类误通过。未知版本直接拒绝。严格字段集合使旧新字段同时出现时不会隐式选择某一个,也意味着新增字段必须显式升级契约;上线前应确认所有调用方是否接受这一限制。
如何迁移和回滚
- 盘点真实字段和消费者版本,用脱敏或人工数据建立旧、新、异常三类样本;不要以本文假数据替代实际服务协议。
- 为每个版本写独立适配规则;无法解析的事件保留错误类别和安全的关联编号,避免把原始敏感内容写入日志。
- 在有授权的测试环境先验证生产者和消费者的部署顺序、版本窗口及回滚方案;监控缺字段、未知版本和拒绝数量。本文没有执行这些上线步骤。
- 确认旧版流量消失并得到维护方认可后再考虑移除兼容,避免突然删除旧字段。
本地验证与排错
本次执行六个 unittest 方法通过,覆盖 v1、v2、未知和布尔版本、新旧字段混用、缺失或空值,以及输入对象不被修改;这些有限样本不证明完整兼容性。输出 unsupported version 时检查版本值及类型;出现 invalid fields 时对照该版本字段集合,不要随意删除冲突字段;result must be nonempty text 表示类型或内容不符合本示例契约。
常见问题
新字段名出现就当作 v2 可以吗? 不建议,本例要求显式版本,避免字段混用造成错误推断。
为什么拒绝多余字段? 这是本演示选择的严格策略。生产契约也可以允许扩展,但应写明保留或忽略规则,并测试安全影响。
这种转换适用于本站 API 吗? 本文使用人工协议,不表示本站或某家厂商使用这些字段;实际对接前应查阅当前官方协议。
小练习与下期预告
给 v1 样本同时加 result,确认被拒;再写一个未支持版本,检查错误。下一篇区分看图和生图接口的能力前置条件。参考:Python json 官方文档。本文由 AI 辅助整理,代码与示例经本地核对。
534



被折叠的 条评论
为什么被折叠?



