使用 oasdiff 拦截 AI 编码助手引入的 API 破坏性变更

2026 年 11 月 7 日，DEV Community 的 AI 栏目刊登了一篇题为《使用 oasdiff 拦截 AI 编码助手引入的 API 破坏性变更》的文章，作者围绕这一主题介绍了他的做法和工具。

文章先给出一个具体场景：某个移动端应用从 GET /orders/{id} 中读取 total_cents 字段。作者描述，AI 编程助手为了让命名“保持一致”，把这个字段改名为 totalCents，随后重新生成了 openapi.yaml，并同步更新了处理逻辑和对应测试，所以测试套件全是绿色。问题在于，这个应用位于另一个仓库，服务端的接口契约就通过这次改动被悄悄改掉了。作者由此提出，AI 编程助手在修改代码和 OpenAPI 规范时，有可能引入跨仓库的破坏性变更，并演示了如何把命令行工具 oasdiff 接入开发流程，在代码合并之前自动发现这类不兼容改动。