NestJS单元测试编译报错:无法找到src/config/app.config模块
- 路径别名适配缺失:BlockchainService 中使用
src/config/app.config的绝对路径导入,依赖生产构建时的 tsconfig 路径解析规则,但 Jest 测试运行时默认不继承该路径配置,无法识别src/开头的模块路径,直接触发模块找不到的编译错误。 - 测试模块配置冗余:测试模块中已经引入了
BlockchainModule、FaucetModule,这两个模块本身会导出对应的BlockchainService、FaucetService,却在 providers 数组中重复声明这两个服务,会触发依赖重复加载,进一步放大配置缺失的报错。
1. 为 Jest 配置路径别名映射
修改项目 Jest 配置文件(通常为根目录 jest.config.js,或 package.json 中的 jest 配置字段),增加模块路径映射规则,将所有 src/ 开头的导入路径指向项目实际的 src 目录:
module.exports = { // 保留原有所有配置项 moduleNameMapper: { '^src/(.*)$': '<rootDir>/src/$1', }, }
配置完成后,Jest 解析 src/config/app.config 这类导入时,会自动定位到 <项目根目录>/src/config/app.config 文件,从根源解决模块找不到的报错。
注意:配置完路径映射后,若仍报模块找不到,可核对
src/config/app.config文件的实际存储路径是否与导入路径完全匹配(注意大小写、相对层级是否正确),避免低级路径书写错误。
2. 修正测试模块的冗余依赖
移除 providers 数组中重复声明的服务,仅保留当前测试场景下需要自定义提供、且未从导入模块导出的依赖。修改后的测试模块初始化代码如下:
const module: TestingModule = await Test.createTestingModule({ imports: [BlockchainModule, FaucetModule], controllers: [UserController], providers: [UserService], }).compile();
原有从模块实例中获取服务的代码(module.get<xxxService>(xxxService))无需调整,只要服务存在于当前依赖注入树中,即可正常获取实例。
(推荐优化)替换硬编码配置导入为标准依赖注入
当前 BlockchainService 中直接硬编码导入 AppConfig 的写法耦合度高,无法在测试场景下灵活 mock 配置值,可替换为 NestJS 官方推荐的 ConfigService 注入模式:
- 将 AppConfig 注册为 ConfigModule 的配置源
- 在 BlockchainService 的构造函数中注入 ConfigService,替换硬编码的 AppConfig 引用
// 改造后的 BlockchainService 构造函数 constructor(private configService: ConfigService) { const blockchainConfig = this.configService.get('blockchain'); this.contract = new OpnCashFactory().attach(blockchainConfig.contract); this.provider = new providers.JsonRpcProvider(blockchainConfig.rpcUrl, blockchainConfig.chainId); }
测试时只需要在测试模块的 imports 中引入注册了 AppConfig 的 ConfigModule.forRoot(),即可正常提供配置值,完全避免硬编码导入带来的路径解析问题,同时提升测试的可扩展性。
内容的提问来源于stack exchange,提问作者Andon Mitev

