使用 oasdiff 攔截 AI 編碼助手引入的 API 破壞性變更

2026 年 11 月 7 日，DEV Community 的 AI 欄目刊登了一篇題為《使用 oasdiff 攔截 AI 編碼助手引入的 API 破壞性變更》的文章，作者圍繞這一主題介紹了他的做法和工具。

文章先給出一個具體場景：某個移動端應用從 GET /orders/{id} 中讀取 total_cents 欄位。作者描述，AI 程式設計助手為了讓命名“保持一致”，把這個欄位改名為 totalCents，隨後重新生成了 openapi.yaml，並同步更新了處理邏輯和對應測試，所以測試套件全是綠色。問題在於，這個應用位於另一個倉庫，服務端的介面契約就通過這次改動被悄悄改掉了。作者由此提出，AI 程式設計助手在修改程式碼和 OpenAPI 規範時，有可能引入跨倉庫的破壞性變更，並演示瞭如何把命令列工具 oasdiff 接入開發流程，在程式碼合併之前自動發現這類不相容改動。