如何在NestJS的模块外部访问环境变量？

你遇到的问题是因为ConfigModule是在Nest的依赖注入（DI）容器初始化阶段加载环境变量的，而helper这类非模块文件如果在Nest启动前就被导入，此时process.env还未被ConfigModule填充，所以无法读取到环境变量。以下是几种可行的解决方法：

方法一：手动使用dotenv加载环境变量 #

直接在helper文件顶部手动调用dotenv加载对应环境文件，和ConfigModule的配置保持一致，确保环境变量提前注入process.env：

// helper/axios-instance.ts
import * as dotenv from 'dotenv';
import * as path from 'path';
import axios from 'axios';

// 复制ConfigModule中配置的envFiles数组，保证加载的文件一致
const envFiles = [
  `.env.${process.env.NODE_ENV || 'development'}`,
  '.env',
];

// 依次加载环境文件，忽略不存在的文件
envFiles.forEach(file => {
  try {
    dotenv.config({ path: path.resolve(process.cwd(), file) });
  } catch (err) {}
});

// 正常使用process.env
export const axiosInstance = axios.create({
  baseURL: process.env.API_BASE_URL,
  timeout: parseInt(process.env.REQUEST_TIMEOUT || '5000'),
});

方法二：将helper包装为Nest提供者（推荐） #

遵循Nest的DI设计模式，把helper封装成可注入的服务，通过ConfigService获取环境变量，更符合Nest架构规范：

1. 创建helper模块和服务 #

// helper/axios-helper.service.ts
import { Injectable } from '@nestjs/common';
import { ConfigService } from '@nestjs/config';
import axios from 'axios';

@Injectable()
export class AxiosHelper {
  readonly instance;

  constructor(private readonly configService: ConfigService) {
    // 通过ConfigService安全获取环境变量，支持类型转换和默认值
    this.instance = axios.create({
      baseURL: this.configService.get<string>('API_BASE_URL'),
      timeout: this.configService.get<number>('REQUEST_TIMEOUT', 5000),
    });
  }
}

// helper/axios-helper.module.ts
import { Module } from '@nestjs/common';
import { AxiosHelper } from './axios-helper.service';

@Module({
  providers: [AxiosHelper],
  exports: [AxiosHelper], // 导出供其他模块使用
})
export class AxiosHelperModule {}

2. 在业务模块中使用 #

在需要用到该helper的模块中导入AxiosHelperModule，然后注入AxiosHelper：

// app.module.ts
import { Module } from '@nestjs/common';
import { ConfigModule } from '@nestjs/config';
import { AxiosHelperModule } from './helper/axios-helper.module';
import { UserService } from './user/user.service';

@Module({
  imports: [
    ConfigModule.forRoot({ 
      envFilePath: envFiles, 
      isGlobal: true 
    }),
    AxiosHelperModule,
  ],
  providers: [UserService],
})
export class AppModule {}

// user/user.service.ts
import { Injectable } from '@nestjs/common';
import { AxiosHelper } from '../helper/axios-helper.service';

@Injectable()
export class UserService {
  constructor(private readonly axiosHelper: AxiosHelper) {}

  async fetchUser(id: string) {
    return this.axiosHelper.instance.get(`/users/${id}`);
  }
}

方法三：延迟加载helper文件 #

确保在Nest初始化完成后再加载helper文件，此时ConfigModule已经完成环境变量的注入：

// main.ts
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  await app.listen(process.env.PORT || 3000);

  // Nest启动完成后再导入helper
  const { axiosInstance } = require('./helper/axios-instance');
  // 后续业务逻辑中使用axiosInstance
}

bootstrap();

注意：这种方法仅适用于helper不在Nest模块初始化阶段被引用的场景，否则仍会出现环境变量未加载的问题。

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