NestJS项目使用dotenv无法加载项目外部.env文件问题排查

• 路径计算基准错误
  dotenv的path参数默认基于**Node进程运行时的工作目录（cwd）**计算，而非main.ts文件的所在路径。比如你在my-apis目录下执行启动命令，工作目录就是my-apis，此时你写的../../../../.env会向上跳转4层，远超过.env的实际位置，自然无法读取。
  解决方法：用__dirname拼接绝对路径，确保不管在哪个目录启动都能准确定位文件：

  import * as dotenv from "dotenv";
  import * as path from "path";
  
  // 从main.ts所在目录向上计算绝对路径
  dotenv.config({ path: path.resolve(__dirname, '../../../../.env') });
  

• 被NestJS自带的ConfigModule覆盖
  如果你项目中引入了@nestjs/config模块，它默认会自动加载项目根目录下的.env文件，且加载时机晚于你手动调用dotenv.config的时机，会覆盖你已经加载的环境变量。
  解决方法：直接通过ConfigModule的配置指定.env路径，不需要手动调用dotenv：

  // 在AppModule中配置
  import { Module } from '@nestjs/common';
  import { ConfigModule } from '@nestjs/config';
  import * as path from 'path';
  
  @Module({
    imports: [
      ConfigModule.forRoot({
        isGlobal: true,
        envFilePath: path.resolve(__dirname, '../../../../.env'),
      }),
    ],
  })
  export class AppModule {}
  

• 编译后文件路径变化
  TypeScript编译后的js文件默认会输出到dist目录下，此时运行的是dist/main.js，__dirname的实际位置变为dist目录下，原来的相对层级就不再匹配。
  解决方法：根据编译后的输出目录调整路径层级，或者在启动命令中指定.env路径，也可以将.env路径配置为环境变量传入。
• .env文件权限或格式错误
  检查运行Node进程的用户是否有.env文件的读取权限，同时确认.env文件格式符合规范，配置项不需要加多余的引号、等号前后不要留多余空格，比如PORT=3000是正确写法。

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