NestJS中Mikro-ORM配置文件无法读取环境变量怎么办？

问题原因 #

Mikro-ORM的配置文件（如mikro-orm.config.ts）会在NestJS的ConfigModule初始化之前被加载，此时process.env还未被@nestjs/config注入环境变量，直接实例化ConfigService也无法获取正确值——因为ConfigService依赖ConfigModule的初始化上下文。

解决方案 #

方案一：使用Mikro-ORM异步配置（推荐） #

通过MikroOrmModule.forRootAsync()让配置依赖NestJS的ConfigService，确保环境变量已加载完成。

修改app.module.ts：

import { Module } from '@nestjs/common';
import { ConfigModule, ConfigService } from '@nestjs/config';
import { MikroOrmModule } from '@mikro-orm/nestjs';
import { SqlHighlighter } from '@mikro-orm/sql-highlighter';
import { Logger } from '@nestjs/common';

@Module({
  imports: [
    ConfigModule.forRoot({
      isGlobal: true, // 全局生效，无需在其他模块重复导入
    }),
    MikroOrmModule.forRootAsync({
      inject: [ConfigService],
      useFactory: (configService: ConfigService) => {
        const logger = new Logger('MikroORM');
        return {
          dbName: configService.get('POSTGRES_DATABASE') || 'database',
          user: configService.get('POSTGRES_USER'),
          password: configService.get('POSTGRES_PASSWORD'),
          host: configService.get('POSTGRES_HOST'),
          port: configService.get<number>('POSTGRES_PORT'),
          type: 'postgresql',
          entities: ['./dist/**/*.entity.js'],
          entitiesTs: ['./src/**/*.entity.ts'],
          highlighter: new SqlHighlighter(),
          migrations: {
            path: './src/feature/database/migrations',
          },
          logger: logger.log.bind(logger),
        };
      },
    }),
  ],
})
export class AppModule {}

之后可删除单独的mikro-orm.config.ts文件，或保留但不再作为Mikro-ORM的默认配置文件使用。

方案二：手动加载.env文件（适合保留独立配置文件的场景） #

在mikro-orm.config.ts开头手动用dotenv加载环境变量，确保读取配置时process.env已被填充。

1. 安装dotenv依赖：

npm install dotenv
# 或 yarn add dotenv

2. 修改mikro-orm.config.ts：

import { Logger } from '@nestjs/common';
import { Options } from '@mikro-orm/core';
import { SqlHighlighter } from '@mikro-orm/sql-highlighter';
import * as dotenv from 'dotenv';
import * as path from 'path';

// 手动加载.env文件，路径根据项目结构调整
dotenv.config({ path: path.resolve(__dirname, '../.env') });

const logger = new Logger('MikroORM');
const MikroORMConfig: Options = {
  dbName: process.env.POSTGRES_DATABASE || 'database',
  user: process.env.POSTGRES_USER,
  password: process.env.POSTGRES_PASSWORD,
  host: process.env.POSTGRES_HOST,
  port: parseInt(process.env.POSTGRES_PORT, 10), // 添加基数参数避免NaN
  type: 'postgresql',
  entities: ['./dist/**/*.entity.js'],
  entitiesTs: ['./src/**/*.entity.ts'],
  highlighter: new SqlHighlighter(),
  migrations: {
    path: './src/feature/database/migrations',
  },
  logger: logger.log.bind(logger),
};
export default MikroORMConfig;

这种方式会在加载配置文件时直接读取.env内容，无需依赖NestJS的ConfigModule初始化。

注意事项 #

• 方案一中，确保ConfigModule.forRoot()的isGlobal设为true，或在MikroOrmModule.forRootAsync()所在模块导入ConfigModule。
• 方案二中，注意.env文件的路径是否正确，若项目结构不同需调整path.resolve的参数。

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