NestJS中环境变量无法读取至配置文件的问题排查与解决

可能成因 #

• 项目根目录未创建.env文件，或文件路径与ConfigModule默认读取路径不匹配
• ConfigModule初始化时未明确指定.env文件路径，导致无法加载环境变量
• 自定义配置函数执行时机早于环境变量加载完成时间，process.env尚未被填充
• 未正确安装@nestjs/config依赖（或依赖缺失导致dotenv未正常工作）

解决步骤 #

1. 创建并配置根目录.env文件 #

在项目根目录新建.env文件，填入需要的环境变量：

PORT=3001
API_URL=http://localhost:3000/api
MONGODB_CONNECTION_STRING=mongodb://localhost:27017/mydb
NODE_ENV=development

2. 调整ConfigModule初始化配置 #

修改app.module.ts中的ConfigModule配置，明确指定.env文件路径（即使在根目录，显式配置也能避免路径歧义），同时确保自定义配置函数在环境变量加载后执行：

import { Module } from '@nestjs/common';
import { ConfigModule } from '@nestjs/config';
import { join } from 'path';
import { config } from 'src/config/configuration';

@Module({
  imports:[ConfigModule.forRoot({
    cache: true,
    isGlobal: true,
    envFilePath: join(process.cwd(), '.env'), // 显式指定.env路径
    load: [config],
  })],
  controllers: [],
  providers: [], 
})
export class AppModule {} // 补充缺失的类导出

3. 通过ConfigService获取配置（推荐） #

避免直接使用process.env，改用NestJS提供的ConfigService来读取配置，这能保证配置已被正确加载和缓存：
例如在main.ts中启动服务：

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import { ConfigService } from '@nestjs/config';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  const configService = app.get(ConfigService);
  const port = configService.get<number>('port');
  await app.listen(port);
}
bootstrap();

4. 确认依赖安装完整 #

执行以下命令确保@nestjs/config及依赖已正确安装：

npm install @nestjs/config

5. 排查.gitignore配置（可选） #

检查项目的.gitignore文件，确保.env未被误加入忽略列表，导致本地缺少该文件。

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