NestJS集成TypeORM时环境变量加载异常：dotenv显示注入但模块初始化时变量为undefined导致数据库连接失败

我之前也遇到过几乎一模一样的问题！核心原因其实是模块加载的执行顺序，再加上你的.env文件可能有个小格式错误，咱们一步步来解决：

为什么会出现这个问题？ #

1. 执行顺序坑：当你在main.ts里导入AppModule的时候，Node.js会先执行AppModule里的所有代码（包括那些调试用的console.log和TypeOrmModule的配置），然后才会执行main.ts里的dotenv.config()。因为import语句是在代码执行阶段之前的解析阶段就处理了，你的app.module.ts在dotenv还没来得及加载.env文件的时候，就已经去读process.env了，自然全是undefined。
2. .env格式小错误：你的.env文件第一行写了env，这是多余的！dotenv会把这一行当成无效的键值对，虽然后面的变量理论上能被解析，但这种多余内容可能引发意料之外的解析问题，最好去掉。

解决方案（按推荐程度排序） #

方案1：使用NestJS官方的ConfigModule（最推荐，完全适配Nest生态） #

NestJS自带的@nestjs/config包专门处理环境变量，能完美和TypeORM集成，还支持变量验证、默认值等实用功能。

1. 先安装依赖：

npm install @nestjs/config

2. 修改app.module.ts，用异步加载的方式获取配置：

import { Module } from '@nestjs/common';
import { TypeOrmModule } from '@nestjs/typeorm';
import { ConfigModule, ConfigService } from '@nestjs/config'; // 新增
import { AppController } from './app.controller';
import { AppService } from './app.service';
import { CourseModule } from './course/course.module';
import { ScoreModule } from './score/score.module';

@Module({
  imports: [
    // 先加载ConfigModule，自动解析根目录的.env文件
    ConfigModule.forRoot({
      isGlobal: true, // 设为全局后，其他模块无需重复导入
      envFilePath: '.env', // 默认就是根目录，可省略
    }),
    // 用forRootAsync异步加载TypeORM配置，确保环境变量已就绪
    TypeOrmModule.forRootAsync({
      useFactory: (configService: ConfigService) => ({
        type: 'postgres',
        host: configService.get<string>('POSTGRES_HOST', 'localhost'), // 第二个参数是默认值
        port: configService.get<number>('POSTGRES_PORT', 5433),
        username: configService.get<string>('POSTGRES_USER', 'postgres'),
        password: configService.get<string>('POSTGRES_PASSWORD', 'postgres'),
        database: configService.get<string>('POSTGRES_DATABASE', 'course-management'),
        entities: [],
        synchronize: true,
        logging: true,
      }),
      inject: [ConfigService], // 注入ConfigService来读取变量
    }),
    CourseModule,
    ScoreModule,
  ],
  controllers: [AppController],
  providers: [AppService],
})
export class AppModule {}

3. 简化main.ts，去掉手动加载dotenv的代码（ConfigModule已经帮我们做了）：

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

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  await app.listen(3000);
}
bootstrap();

方案2：用Node的--require参数提前加载dotenv #

如果你不想引入新依赖，可以让Node.js在加载任何模块之前先加载dotenv。修改package.json的启动脚本：

{
  "scripts": {
    "start": "node --require dotenv/config dist/main.js",
    "start:dev": "ts-node --require dotenv/config src/main.ts"
  }
}

这样dotenv会在AppModule加载前就解析.env文件，process.env就能拿到正确的值。

方案3：手动调整加载顺序 #

创建一个单独的环境加载文件：

// src/env-loader.ts
import * as dotenv from 'dotenv';
dotenv.config();

然后在main.ts的最顶部导入这个文件，确保它在AppModule之前执行：

import './env-loader.ts'; // 必须放在最前面！
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  await app.listen(3000);
}
bootstrap();

额外检查点 #

• 修正.env文件格式，去掉第一行的env，正确格式如下：

POSTGRES_HOST=localhost
POSTGRES_PORT=5433
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
POSTGRES_DATABASE=course-management

• 确认.env文件确实在项目根目录（和package.json同层级），如果不在，要在加载时指定路径（比如dotenv.config({ path: './config/.env' })或ConfigModule.forRoot({ envFilePath: './config/.env' })）。
• 确认你的数据库服务确实在监听5433端口（默认是5432，你这里改成了5433），并且手动用psql能连接成功。

按照上面的方法修改后，应该就能正常连接数据库了！我当时用的是方案1，后来还顺便用上了ConfigModule的Joi验证功能，能提前校验环境变量是否存在，避免上线后踩坑。

内容来源于stack exchange