如何在NestJS中使用.env文件？按文档操作仍报错

问题原因 #

你遇到的问题是因为TypeOrmModule.forRoot()是同步初始化的，而ConfigModule.forRoot()加载环境变量是异步过程。当TypeORM模块开始初始化时，环境变量还没被注入到process.env中，所以直接调用process.env.DATA_HOST会拿到undefined或错误值。

解决方案 #

不要直接在同步配置里使用process.env，改用TypeOrmModule.forRootAsync()结合ConfigService异步获取环境变量，这是NestJS官方推荐的正确实现方式。

修改后的代码示例 #

import { Module } from '@nestjs/common';
import { ConfigModule, ConfigService } from '@nestjs/config';
import { TypeOrmModule } from '@nestjs/typeorm';
import { HttpModule } from '@nestjs/axios';
import { AppController } from './app.controller';
import { AppService } from './app.service';
import { UsersModule } from './users/users.module';
import { AuthModule } from './auth/auth.module';
import { CategoryModule } from './category/category.module';
import { TutorsModule } from './tutors/tutors.module';
import { UserEntity, TutorEntity } from './entities';

@Module({
  imports: [
    HttpModule,
    ConfigModule.forRoot({ isGlobal: true }),
    TypeOrmModule.forRootAsync({
      useFactory: (configService: ConfigService) => ({
        type: 'postgres',
        host: configService.get<string>('DATA_HOST'),
        port: configService.get<number>('DATA_PORT'),
        username: configService.get<string>('DB_USER'),
        password: configService.get<string>('DB_PASSWORD'),
        database: configService.get<string>('DB_NAME'),
        synchronize: true,
        entities: [UserEntity, TutorEntity],
      }),
      inject: [ConfigService],
    }),
    UsersModule,
    AuthModule,
    CategoryModule,
    TutorsModule,
  ],
  controllers: [AppController],
  providers: [AppService],
})
export class AppModule {}

额外说明 #

1. 确保项目根目录下的.env文件已正确配置DATA_HOST、DB_USER、DB_PASSWORD等变量。
2. 若需自定义.env文件路径，可在ConfigModule.forRoot()中添加envFilePath参数，例如：ConfigModule.forRoot({ isGlobal: true, envFilePath: '.env.development' })。

内容的提问来源于stack exchange，提问作者Максим Дмитриевич