Tech
为什么我的线上 API 契约只以 CI 流水线无法察觉的方式出现问题？
81
机会
消费者驱动的契约测试能在合并前捕获破坏性变更，但它将契约固定在 PR 时间点，无法检测服务上线后逐步积累的语义漂移。团队在生产热修复中添加未记录字段、为解除事故而更改错误结构，或在不修改 OpenAPI 规范的情况下放宽校验。World Quality Report 2025 将未被发现的 API schema 漂移列为分布式系统生产事故的三大原因之一，并估计约 70% 的生产 API 故障通过了全部 CI 检查。目前没有任何工具能持续监控线上真实流量与已发布契约的一致性，并在违规行为积累时及时暴露，而非等到合并时才发现。
为什么重要
将实际线上流量与已发布契约进行对照监控，能够弥合 API 所承诺的内容与其悄然停止交付的内容之间的最后差距。
我如何评估机会
机会评分是我的个人判断，而非量化指标：痛苦程度、发生频率，以及当前解决方案的匮乏程度。分数越高，意味着我认为越值得去构建。
严重性8/10
出现时造成的痛苦程度。
频率8/10
人们实际遇到它的频率。
空白空间7/10
当前针对它的优质工具有多匮乏。