NX升级后非NX_前缀环境变量无法加载及动态设置失效求助

问题1：非NX_前缀的环境变量无法加载 #

NX最新版本默认仅将带有NX_前缀的环境变量暴露给应用，这是官方为环境变量隔离新增的策略。要加载非前缀变量，可通过以下配置解决：

• 项目级配置（仅当前应用生效）：
  编辑apps/my-app/project.json，在对应target（如build、serve）的options中添加allowedEnv数组，列出需要允许的变量：

  {
    "targets": {
      "serve": {
        "options": {
          "allowedEnv": ["NODE_ENV", "ORG_HOST_ID"]
        }
      },
      "build": {
        "options": {
          "allowedEnv": ["NODE_ENV", "ORG_HOST_ID"]
        }
      }
    }
  }
  

• 全局配置（所有应用生效）：
  编辑根目录的nx.json，在defaults下添加allowedEnv：

  {
    "defaults": {
      "allowedEnv": ["NODE_ENV", "ORG_HOST_ID"]
    }
  }
  

配置后重启NX服务，非前缀变量即可正常从.env或系统环境中加载。

问题2：编程式修改process.env失效 #

NX在启动/构建过程中会对process.env做封装或快照处理，直接赋值process.env[prop] = value可能因属性不可写或快照隔离而失效，可尝试以下方案：

方案1：使用Object.defineProperty强制赋值 #

替换原代码中的直接赋值，用Object.defineProperty修改环境变量：

// 替换原赋值语句
Object.defineProperty(process.env, macroCaseKey, {
  value: masterEnvConfig[macroCaseKey] ? process.env[macroCaseKey] : remoteConfig[key],
  writable: true,
  enumerable: true
});

方案2：改用自定义配置对象（推荐） #

避免依赖process.env，创建全局配置对象来管理远程加载的配置：

// 全局配置文件（如src/config.ts）
export const appConfig = { ...process.env };

// 在远程配置加载逻辑中更新
Object.keys(remoteConfig).forEach(key => {
  const macroCaseKey = key
    .split(/(?=[A-Z])/)
    .join('_')
    .toUpperCase();
  appConfig[macroCaseKey] = masterEnvConfig[macroCaseKey] ? appConfig[macroCaseKey] : remoteConfig[key];
});

// 应用中直接引用appConfig而非process.env

方案3：在NX启动前注入环境变量 #

如果远程配置是启动前就能获取到的，可修改package.json中的启动脚本，先执行配置加载脚本再启动NX：

{
  "scripts": {
    "start:api": "node scripts/load-remote-config.js && nx serve my-app"
  }
}

在scripts/load-remote-config.js中加载远程配置并设置环境变量，NX启动时会读取这些已设置的变量。

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