NestJS跨模块调用外部变量与函数？路径导入异常求解

• 相对路径层级错误：你使用的./../../../src/common/helper/cast.helper相对路径，和主程序模块所在的目录层级不匹配，导致模块找不到；但e2e测试的目录结构刚好让这个路径能命中文件，所以测试可以正常运行。
• 绝对路径环境适配问题：改成src/common/helper/cast.helper绝对路径后，主程序运行时的模块解析根是项目根目录，能定位到文件；但e2e测试的运行环境（工作目录或tsconfig配置）和主程序不一致，解析该绝对路径时找不到对应文件，导致测试失效。

1. 配置TypeScript路径别名（最省心） #

在项目根目录的tsconfig.json和tsconfig.spec.json（e2e测试使用的配置文件）中添加paths配置，统一路径解析规则：

{
  "compilerOptions": {
    "baseUrl": "./",
    "paths": {
      "@common/*": ["src/common/*"]
    }
    // 保留其他原有配置
  }
}

之后在代码中使用别名导入：

import { toNumber } from '@common/helper/cast.helper';

不管是主程序还是e2e测试，TypeScript都会自动把@common/*映射到正确的实际路径，彻底解决模块解析问题。

2. 封装成NestJS公共模块（符合框架规范） #

把通用函数、常量打包成CommonModule，借助Nest的模块机制实现共享，既解决路径问题，也符合架构设计：

• 在src/common目录下创建common.module.ts：

import { Module } from '@nestjs/common';
import * as CastHelper from './helper/cast.helper';

@Module({
  providers: [
    { provide: 'CAST_HELPER', useValue: CastHelper }
  ],
  exports: ['CAST_HELPER'] // 导出供其他模块使用
})
export class CommonModule {}

• 在需要使用的业务模块中导入CommonModule：

import { Module } from '@nestjs/common';
import { CommonModule } from '../common/common.module';

@Module({
  imports: [CommonModule],
  // 其他模块配置
})
export class YourBusinessModule {}

• 在服务或控制器中注入使用：

import { Inject, Injectable } from '@nestjs/common';

@Injectable()
export class YourService {
  constructor(@Inject('CAST_HELPER') private readonly castHelper: typeof CastHelper) {}

  doSomething() {
    const num = this.castHelper.toNumber('456');
  }
}

3. 检查e2e测试的tsconfig配置 #

如果项目使用单独的tsconfig.e2e.json，确保它继承主配置的路径规则，示例如下：

{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    // e2e专属配置，比如outDir等
  }
}

内容的提问来源于stack exchange，提问作者Iynga Iyngaran Iyathurai