MSW API 模拟

要解决的问题

前端和集成测试里，请求往往会带来三种典型麻烦：

• 后端未就绪：接口还在开发中，前端只能对着一份可能过时的接口文档写代码，联调时大量返工。
• 测试不稳定：测试直接打真实服务，响应时长、偶发错误码、数据污染都会让用例时好时坏，且每次跑测试都会写脏数据。
• Mock 失真：随手在组件里塞的假数据，慢慢和真实接口的路径、响应结构、错误格式脱节，等真联调时才发现字段名对不上。

技能如何工作

该技能围绕 Mock Service Worker（MSW） 组织，把 mock 当成一项需要与真实端点对齐的工程任务，而不是临时写几段假响应。核心能力包括：

• 为真实接口逐一梳理并搭建请求处理器（request handlers），覆盖路径、方法与响应结构。
• 在本地开发和测试环境中用 MSW 拦截网络请求，把真实调用挡在边界之外。
• 让 mock 的响应忠实于真实端点，包括响应体、状态码与错误格式，降低联调风险。

关键步骤大致是：先列出被依赖的真实端点，再按 MSW 的方式编写对应的 handler，然后在本地或测试环境挂载 MSW 使拦截生效，最后验证被测代码在无真实网络下的行为。

适用边界与注意点

这是一个面向 MSW 的任务型技能，不是通用 mock 方案说明书，前提是你的项目已经或愿意引入 MSW。资料中未提供自动提取到的安装或使用说明，接入前应先审阅上游项目，确认 handler 的写法与团队现有约定是否匹配，尤其是在涉及鉴权、文件上传等复杂场景时。

另外，它关注的是接口层模拟，不能替代真实的网络问题排查：DNS、CORS、证书、CDN 缓存等基础设施问题不会因为 mock 而暴露。敏感工作流（如线上数据脱敏、支付链路）中运行前，务必先在隔离环境验证 handler 的匹配范围，避免误拦截本应真实发出的请求。