上游系统改了接口字段，定制软件怎样提前发现影响并平稳切换

上游系统改接口，不能等页面报错后再找字段。应维护实际使用的字段与业务含义，要求变更通知和新版本样本，先验证读写结果，再按兼容窗口切换。即使接口仍返回成功，金额单位、状态含义或分页方式变化，也可能让定制软件得到错误结果。

建立“本系统实际依赖什么”的清单

不必复制上游所有接口文档，先列本系统真正消费的接口、字段、调用方向、认证方式、业务用途和负责人。一个字段影响哪里也要记录：订单状态可能同时用于列表颜色、审批判断、导出和统计筛选，只修列表会留下其他错误。

每个依赖至少保留接口版本、字段类型、可空条件、枚举解释、金额单位、时间与时区，以及分页和更新时点。按照系统对接责任划分补充谁发通知、谁提供样本、谁批准切换，使定制软件开发中的接口交付能够延续到维护阶段。

用两层检查发现“成功但不正确”

第一层检查结构和缺失值

将约定结构与测试响应比对，发现字段删除、类型改变、必填增加、枚举新增或列表改为分页。保留正常、空值、无权限、无记录和多页样本。未知状态应进入明确的待处理分支，不能自动归为“已完成”；缺少金额也不能默认为零后继续统计。

第二层核对业务含义

选取一笔有取消、退款或跨日变化的记录，比较升级前后页面、导出和汇总结果。同样叫“金额”的字段，可能从含税变成未税；同一个时间字符串，可能改为另一时区。这类问题靠字段存在性检查无法发现。

Google AIP-180 兼容性指南明确把语义兼容纳入考虑，并指出字段改名、类型或默认行为变化可能破坏既有客户端。它是设计参考，不代表上游供应商自动遵守；本项目仍须确认实际契约和通知渠道。

按上游条件选择切换方式

• 新旧版本可并存：先接入新版本做只读核对，明确比较窗口、差异处理人和旧版本停用时间，避免试验阶段重复发起写操作。
• 必须同时升级：提前锁定联调环境、发布时间和停写范围，完成样本回归后在维护窗口切换，保留人工处理入口。
• 无法获得测试版本：记录可验证范围与未知项，要求上线当天的观察、暂停条件和支持人到位，不将猜测写成已兼容。

兼容窗口没有通用天数，应覆盖双方改造、部署和业务确认的实际周期。接口适配层可以转换格式，但不能凭技术推测补出不存在的业务含义；金额定义变更应由数据负责人确认映射。

切换验收追到下游结果和回退边界

切换前保存旧版样本、新版样本、映射规则和测试结果，注明调用的是哪个环境与版本。切换后检查错误率之外，还应观察约定记录的缺失字段、未知状态、数据更新时间和业务合计，防止“全部返回成功”掩盖内容错误。

若新版只参与查询，恢复旧查询入口通常较简单；若已按新版写入单据，就要核对这些单据是否能被旧版读取、是否需要补偿处理。不能仅把接口地址改回去，再把结果未知的请求重发一遍。回退触发条件、执行人和需人工核对的记录应在发布前确定。

验收包保留受影响功能清单、版本与字段差异、正反例样本、切换记录和未解决限制。按上线后维护范围约定第三方升级属于何种工作、通知失效如何处理，以及后续新增字段是否需要单独评估；不要用笼统“接口维护”代替可核对的责任。