NestJS单元测试与项目导入路径冲突问题求助

架构老林

2026-8-15

解决NestJS单元测试与业务文件导入路径兼容问题

问题根源

单元测试框架（Jest）与TypeScript编译器（tsc）对模块路径的解析规则默认不一致：虽然你在tsconfig.json中设置了baseUrl: "./"，让业务文件可以用src/xxx的绝对路径导入，但Jest并不会自动继承这个配置，导致测试文件中使用src/xxx导入时找不到模块；而业务文件使用相对路径时，又不符合baseUrl的解析逻辑，引发启动错误。

解决方案：统一路径规则 + 同步Jest配置

1. 统一使用基于`baseUrl`的绝对导入

所有业务文件和测试文件都采用import { SyncService } from 'src/sync.service';这类路径，不要混用相对路径。

2. 配置Jest解析`src/`开头的路径

在项目根目录的jest.config.js（或jest.config.ts）中添加moduleNameMapper配置，让Jest能正确映射src/路径到实际文件位置：

module.exports = {
  // 保留原有其他配置（如moduleFileExtensions、testRegex等）
  moduleNameMapper: {
    '^src/(.*)$': '<rootDir>/src/$1',
  },
  roots: ['<rootDir>/src', '<rootDir>/test'], // 确保测试目录被Jest识别
};

3. 确保TypeScript配置正确

检查根目录的tsconfig.json，确认baseUrl和include配置无误：

{
  "compilerOptions": {
    "baseUrl": "./",
    // 其他编译选项（如target、module等）
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}

如果项目使用了tsconfig.spec.json（NestJS初始化项目默认生成），确保它继承主配置：

{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "outDir": "./dist/out-tsc/spec",
    "types": ["jest", "node"]
  },
  "include": ["src/**/*.spec.ts", "src/**/*.d.ts"]
}