使用dotenv后NestJS应用热重载失效问题求助

原因分析 #

当你用 dotenv-cli 包裹 nest build --watch 命令时，dotenv-cli 会创建独立子进程执行后续的 NestJS 构建命令。虽然子进程能加载 .env 文件，但 webpack 的热模块替换（HMR）机制依赖父进程与编译进程间的信号传递，dotenv-cli 的进程隔离会阻断这种交互，最终导致热重载失效。

解决方案 #

方案一：使用 NestJS 官方 @nestjs/config 模块加载环境变量（推荐） #

这是最贴合 NestJS 生态的方案，无需在命令行层面处理环境变量，同时能保证热重载正常运行：

1. 安装依赖：

npm install @nestjs/config

2. 在根模块 AppModule 中配置 ConfigModule，指定你的 .env 文件路径：

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

@Module({
  imports: [
    ConfigModule.forRoot({
      envFilePath: ['./envs/.env.development', '../../prisma/.env.development'],
      isGlobal: true, // 让环境变量在全模块可用
      ignoreEnvFile: process.env.NODE_ENV === 'production', // 生产环境可忽略.env文件
    }),
    // 其他业务模块
  ],
})
export class AppModule {}

3. 恢复启动脚本为：

"start:dev": "nest build --watch"

此时环境变量会被 @nestjs/config 自动加载，热重载功能也能正常工作。

方案二：调整命令执行方式（兼容 dotenv-cli） #

如果坚持使用 dotenv-cli，可以通过添加 -- 参数让 dotenv-cli 完整传递后续命令参数，避免进程隔离问题（注：该方式在 Windows 系统需额外适配）：

"start:dev": "dotenv -e ./envs/.env.development -e ../../prisma/.env.development -- nest build --watch"

额外确认 #

你当前 main.ts 中的 HMR 逻辑是正确的，无需修改：

if (module.hot) {
  module.hot.accept();
  module.hot.dispose(() => app.close());
}

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