项目复盘 · 发布 2026年6月3日
第三方接口复盘:对方改了字段没通知
合作方升级接口版本,返回结构悄然变化,系统在两周后才出现异常。
我们的系统依赖一家物流服务商的轨迹查询接口。某天开始,部分订单的物流状态停止更新。排查发现对方把字段从字符串改成了对象,文档没有同步更新。
为什么两周后才发现
异常被吞掉了。解析失败时抛出的错误被 catch 住,只写了一条日志,没有告警。
没有契约测试。我们只在对接时验证过一次,之后没有持续校验。
用户反馈路径太长。客户发现问题后先联系客服,客服再转技术,已经过去几天。
改进措施
对接第三方接口时增加每日契约校验任务,字段结构变化立即告警。
解析异常统一上报到监控,不再静默处理。
与关键服务商约定版本变更提前通知,并在合同里写明。
依赖第三方就必然面对变化。能做的是尽早发现,而不是假设对方不会改。