如何在NX集成式Monorepo中为每个Node服务配置独立.env文件

问题原因 #

NX默认以仓库根目录作为工作目录启动服务，直接使用dotenv.config()会默认读取根目录的.env，而非服务自身目录下的文件，导致出现文件找不到或读取值为undefined的问题。

解决方案 #

1. 手动指定.env文件路径（最灵活） #

在每个服务的入口文件中，通过path模块明确指定当前服务目录下的.env路径：

TypeScript示例

import dotenv from 'dotenv';
import path from 'path';

// 加载当前服务目录下的.env
dotenv.config({ path: path.resolve(__dirname, '.env') });

CommonJS示例

const dotenv = require('dotenv');
const path = require('path');

dotenv.config({ path: path.resolve(__dirname, '.env') });

2. 修改NX服务启动的工作目录 #

在对应服务的project.json（比如apps/app1/project.json）中，给serve目标添加cwd配置，将启动时的工作目录切换到服务自身目录：

{
  "targets": {
    "serve": {
      "executor": "@nx/node:node",
      "options": {
        "buildTarget": "app1:build",
        "cwd": "apps/app1"
      }
    }
  }
}

启动服务时，dotenv会自动读取当前工作目录（即服务目录）下的.env文件，无需额外配置路径。

3. 使用NX自带的环境变量加载配置 #

利用NX的envFile配置项，在服务的project.json中指定要加载的.env文件路径，让NX在构建和启动时自动处理：

{
  "targets": {
    "build": {
      "executor": "@nx/js:tsc",
      "options": {
        "outputPath": "dist/apps/app1",
        "main": "apps/app1/src/main.ts",
        "tsConfig": "apps/app1/tsconfig.app.json",
        "envFile": "apps/app1/.env"
      }
    },
    "serve": {
      "executor": "@nx/node:node",
      "options": {
        "buildTarget": "app1:build",
        "envFile": "apps/app1/.env"
      }
    }
  }
}

这种方式无需手动引入dotenv，NX会自动完成环境变量的注入工作。

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