TypeScript CRA Jest导入类型错误：出现未定义导入问题

问题背景 #

在React项目中遇到偶发的导入相关TypeError，与测试代码修改无关，错误示例如下：

TypeError: (0 , date_1.formatDate) is not a function
TypeError: Cannot read properties of undefined (reading 'default')
TypeError: _ordersService.default is not a constructor

已确认：

• 命名/默认导入逻辑正确，生产环境应用运行正常
• Jest配置已设置moduleDirectories: ['node_modules', 'src']，尝试相对导入无效
• 测试环境兼容CRA 5.0.1的react-scripts test、独立Jest 29.1.2+ts-jest
• 仅部分测试失败，其余正常，历史上所有测试曾全部通过
• 已尝试更新Jest版本、同步@types/jest版本，问题未解决

可能的原因与解决方法 #

1. Jest模块缓存污染 #

Jest默认会缓存已加载的模块，若某模块在测试执行中被意外修改（如异步操作、全局变量污染），后续测试会读取异常的缓存版本。

• 临时禁用缓存运行测试：

  jest --no-cache
  # 或使用CRA时
  react-scripts test --no-cache
  

• 手动删除Jest缓存目录：rm -rf node_modules/.cache/jest（Windows环境可直接删除对应文件夹）

2. 并行测试的竞态条件 #

Jest默认开启并行测试，多个测试文件同时操作共享模块时，可能导致模块导出状态异常。

• 在jest.config.ts中禁用并行：

  export default {
    // 其他配置
    maxWorkers: 1,
  }
  

• 对依赖共享模块的测试添加钩子，重置模块状态：

  import { resetModule } from './shared-module';
  
  afterEach(() => {
    resetModule();
  });
  

3. ES模块与CommonJS互导兼容性问题 #

项目中混合使用ES模块（export/import）与CommonJS模块（module.exports/require）时，Jest的模块解析偶发会出现偏差。

• 在jest.config.ts中调整转译忽略规则，确保依赖模块被正确处理：

  export default {
    // 其他配置
    transformIgnorePatterns: ['/node_modules/(?!your-es-module-dep)/'],
  }
  

• 检查出错模块的导出方式，添加兼容处理：比如在CommonJS模块末尾添加export default = module.exports;

4. TypeScript编译配置与Jest解析不匹配 #

TypeScript编译后的模块格式与Jest的解析逻辑不一致，可能导致运行时导出与类型定义不符。

• 检查tsconfig.json的核心配置：

  {
    "module": "ESNext",
    "target": "ES6",
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true
  }
  

• 查看编译后的JS文件，确认模块实际导出是否符合预期（比如是否存在default导出）

5. 第三方依赖版本冲突 #

项目中存在多版本Jest、ts-jest或Babel相关依赖，导致模块解析逻辑混乱。

• 清理依赖后重新安装：

  rm -rf node_modules package-lock.json
  npm install
  # 或使用yarn
  rm -rf node_modules yarn.lock
  yarn install
  

• 检查依赖树排查冲突：

  npm ls jest
  # 或
  yarn list jest
  

内容的提问来源于stack exchange，提问作者Dmitriy Metelya