背景

在一个中后台项目中，我们遇到了一个典型但长期被低估的问题：

• Swagger 文档先于页面设计完成
• 页面实际需要的数据结构与现有接口不一致
• 错误码基本等同于 HTTP Status，语义不足
• 前端页面中大量 if (res.code !== 0) + toast(res.message)

结果是：

• 前后端对接口结构理解不一致
• Mock 与真实接口行为不一致
• 错误提示不可控，难以国际化
• 后续维护成本持续升高

我们最终决定 重构接口契约的生产流程，而不是继续修补页面代码。

为什么要重新理解 MSW

在很多项目里，MSW 被当成了：

• 一个 mock 数据工具
• 一个本地调试的临时方案
• 一个替代 mock.js 的库

但在实际工程中，如果这样使用 MSW，价值会非常有限，甚至会制造新的混乱。

我们最终达成的共识是：

MSW 不是用来“造假数据”的，而是用来“定义接口行为”的。