NestJS中.env变量引用返回undefined问题排查求助

以下是针对你遇到的问题的核心排查点和具体修复方案：

1. AuthService中的低级调用错误 #

你在auth.service.ts中对ConfigService的调用存在两处错误：

• 构造函数注入的是小写的configService，但调用时写成了大写的ConfigService
• 获取环境变量时使用了未定义的TIMESTAMP_URL变量，而非字符串键名'TIMESTAMP_URL'

修复后的auth.service.ts关键代码：

import { Injectable, Logger } from '@nestjs/common';
import { ConfigService } from '@nestjs/config';
import axios from 'axios';
import FormData from 'form-data';

@Injectable()
export class AuthService {
  private readonly logger = new Logger(AuthService.name);

  // 补全构造函数括号
  constructor(private readonly configService: ConfigService) {}

  async timestamp(timestampDto: TimestampDto, timeStampUrl: string, authorization: string): Promise<any> {
    try {
      // ...其他代码

      // 修正调用方式：小写configService + 字符串键名
      const downstreamAPIUrl = this.configService.get<string>('TIMESTAMP_URL');
      console.log('API URL: ' + downstreamAPIUrl);

      // ...其他代码
    } catch (error) {
      this.logger.error('请求下游服务失败', error.stack);
      throw error;
    }
  }
}

2. 环境变量文件路径计算错误 #

项目编译后，__dirname指向的是dist目录下的编译文件路径，而你的envs文件夹位于src目录下，直接用__dirname拼接路径会导致找不到文件。

修复方案：用项目根目录拼接路径 #

修改app.module.ts中的路径计算逻辑，使用process.cwd()获取项目根目录：

import { Logger, Module } from '@nestjs/common';
import { AuthModule } from './abcd/authentication/auth.module';
import { HealthModule } from './health-api/health.module';
import { ConfigModule } from '@nestjs/config';
import * as path from 'path';

// 优先使用传入的NODE_ENV，默认用development
const envFileName = `.env.${process.env.NODE_ENV || 'development'}`;
// 基于项目根目录拼接正确的envs路径
const envPath = path.join(process.cwd(), 'src/production/abcd/app/envs', envFileName);
Logger.log(`使用配置文件路径: ${envPath}`);

@Module({
  imports: [
    ConfigModule.forRoot({ 
      isGlobal: true, 
      envFilePath: envPath,
      ignoreEnvFile: false
    }),
    AuthModule,
    HealthModule
  ]
})
export class AppModule { }

额外配置：将envs文件夹复制到dist目录 #

在nest-cli.json中添加assets配置，确保编译时将envs文件夹复制到dist目录：

{
  "compilerOptions": {
    "assets": ["src/production/abcd/app/envs/**/*"],
    "watchAssets": true
  }
}

3. 手动加载dotenv与Nest ConfigModule冲突 #

你在config.ts中手动调用了dotenv.config()，但@nestjs/config本身已经封装了dotenv的功能，重复加载会导致冲突。

修复方案：删除手动dotenv加载逻辑 #

直接删除config.ts中的config({ path: envpath })调用，改用ConfigService初始化你的APPCONFIG：

import { Injectable } from '@nestjs/common';
import { ConfigService } from '@nestjs/config';

@Injectable()
export class AppConfigService {
  constructor(private readonly configService: ConfigService) {}

  get enableCors(): boolean {
    return this.configService.get<boolean>('ENABLE_CORS', false);
  }

  get swaggerScheme(): 'http' | 'https' {
    return this.configService.get<'http' | 'https'>('SWAGGER_SCHEME', 'https');
  }

  get appVersion(): string {
    return this.configService.get<string>('APP_VERSION', '1.0.0');
  }

  get dependentServiceBaseUrl(): string {
    return this.configService.get<string>('DEPENDENT_SERVICE_BASE_URL', '');
  }
}

4. 确认NODE_ENV已正确传递 #

启动应用时必须明确设置NODE_ENV，否则会加载默认的.env.development或找不到对应文件：

• Linux/macOS：

  NODE_ENV=prod npm run start:prod
  

• Windows（命令提示符）：

  set NODE_ENV=prod && npm run start:prod
  

• Windows（PowerShell）：

  $env:NODE_ENV="prod"; npm run start:prod
  

最后检查点 #

• 确认envs文件夹下存在对应环境的文件（如.env.prod）
• 环境变量文件中的键名与代码中使用的完全一致（区分大小写）
• 确保ConfigModule.forRoot的isGlobal: true已设置，避免其他模块重复导入

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