NX生成的Nest.js项目仅读取.env，无法识别其他环境配置文件

你遇到的问题大概率是NX CLI的环境变量加载机制与Nest.js的ConfigModule存在冲突导致的。因为NX本身有一套自己的环境变量加载逻辑，会优先于Nest的ConfigModule加载.env相关文件，或者覆盖后续读取的变量。结合你用Nest CLI重建项目能正常运行的情况，下面给出具体的排查和解决步骤：

可能的原因 #

1. NX默认会自动加载根目录下的.env、.env.local、.env.<环境名>、.env.<环境名>.local文件，加载优先级高于Nest的ConfigModule配置，导致你指定的文件被忽略。
2. NX启动项目时未正确传递NODE_ENV环境变量，或者传递的变量与你预期的环境不匹配。
3. NX的缓存机制保留了旧的配置，导致新的.env文件内容未被读取。
4. .env文件的路径配置错误，ConfigModule找不到指定的文件。

解决步骤 #

1. 禁用NX自动加载环境变量 #

NX默认会自动加载.env文件，你可以在启动项目时添加--no-env-file参数，让NX不干预环境变量加载，交给Nest的ConfigModule处理：

nx serve 你的项目名 --no-env-file

或者在项目的project.json文件中修改serve目标的配置，永久添加该参数：

{
  "targets": {
    "serve": {
      "executor": "@nx/nest:serve",
      "buildTarget": "你的项目名:build",
      "options": {
        "noEnvFile": true
      }
    }
  }
}

2. 确保NODE_ENV环境变量正确设置 #

Nest的ConfigModule会根据NODE_ENV来匹配对应的环境文件，你需要确保启动时该变量正确传递：

NODE_ENV=development nx serve 你的项目名

或者在project.json的serve配置中直接指定环境变量：

{
  "targets": {
    "serve": {
      "executor": "@nx/nest:serve",
      "buildTarget": "你的项目名:build",
      "options": {
        "env": {
          "NODE_ENV": "development"
        }
      }
    }
  }
}

同时，你可以调整ConfigModule的envFilePath为动态生成，确保匹配当前环境：

import { Module } from '@nestjs/common';
import { ConfigModule } from '@nestjs/config';

const env = process.env.NODE_ENV || 'development';

@Module({
  imports: [
    ConfigModule.forRoot({
      envFilePath: [
        `.env.${env}.local`,
        `.env.${env}`,
        '.env',
      ],
      isGlobal: true,
      cache: true,
    }),
  ],
})
export class AppModule {}

3. 清理NX缓存 #

NX的缓存可能会保留旧的配置，执行以下命令清理缓存后重启项目：

nx reset

4. 检查.env文件路径 #

如果你的Nest项目在NX monorepo的apps目录下，确保envFilePath的路径是相对于Nest项目根目录的。比如项目结构是：

根目录/
  apps/
    your-nest-app/
      src/
        app.module.ts
  .env.development.local
  .env

那么envFilePath应该写成相对路径：

envFilePath: [
  '../../.env.development.local',
  '../../.env',
],

5. 验证环境变量加载顺序 #

确保envFilePath数组中，更具体的环境文件排在前面（比如.env.development.local要在.env之前），这样后面的文件不会覆盖前面的变量。

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