前端接口契约治理实践:MSW + 错误码 + OpenAPI 的一次落地
背景
在一个中后台项目中,我们遇到了一个典型但长期被低估的问题:
- Swagger 文档先于页面设计完成
- 页面实际需要的数据结构与现有接口不一致
- 错误码基本等同于 HTTP Status,语义不足
- 前端页面中大量
if (res.code !== 0)+toast(res.message)
结果是:
- 前后端对接口结构理解不一致
- Mock 与真实接口行为不一致
- 错误提示不可控,难以国际化
- 后续维护成本持续升高
我们最终决定 重构接口契约的生产流程,而不是继续修补页面代码。
