升级MSW至v2后'msw/node'模块找不到问题求助

核心原因：MSW v2 导入路径变更 #

MSW v1 支持从 msw/node 导入 setupServer，但v2版本已调整包结构，正确导入路径改为直接从 msw 导入：

import { setupServer } from 'msw'

即便 node_modules 中存在旧路径文件，v2的模块导出逻辑已变更，仍会导致解析失败。

其他可能原因及解决方法 #

1. 依赖安装不完整或缓存问题 #

• 清理pnpm缓存并重新安装依赖：

  pnpm store prune
  pnpm install
  

• 确认 package.json 中MSW版本为v2.x.x：

  "dependencies": {
    "msw": "^2.0.0"
  }
  

2. TypeScript 模块解析配置问题 #

检查 tsconfig.json 中模块相关配置，适配Node.js环境：

{
  "compilerOptions": {
    "module": "NodeNext", // 或 "CommonJS"/"ESNext"，匹配项目模块系统
    "moduleResolution": "NodeNext",
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true
  }
}

若项目使用ES模块，需在 package.json 中添加 "type": "module"。

3. Jest 配置的模块映射问题 #

若通过Jest运行测试，确保配置能正确解析MSW路径：

module.exports = {
  moduleNameMapper: {
    '^msw$': '<rootDir>/node_modules/msw/dist/index.js'
  },
  testEnvironment: 'node'
}

同时确认 testEnvironment 设置为 node，匹配服务器端测试场景。

4. 修正出错文件的导入代码 #

直接替换旧导入语句：

// 旧写法（v1）
import { setupServer } from 'msw/node'

// 新写法（v2）
import { setupServer } from 'msw'

错误提示验证 #

若错误提示为 Cannot find module 'msw/node' or its corresponding type declarations，可直接确认是导入路径变更导致，优先调整导入语句即可解决。

内容的提问来源于stack exchange，提问作者Marcus Ruddick