Node.js应用通过PM2部署时环境变量无法读取的问题求助

核心问题解答 #

• 是否需要在应用中导入ecosystem.config.js？
  不需要。这个文件是PM2的专属配置文件，Node.js应用本身不需要导入或读取它，PM2会在启动时解析该文件的配置，并将环境变量注入到应用进程中。

• 是否要通过PM2启动ecosystem.config.js而非应用本身？
  是的，这是关键操作。如果仍用pm2 start app.js这类命令直接启动应用，PM2不会加载你的ecosystem.config.js配置。正确启动命令：

pm2 start ecosystem.config.js

若之前已通过其他方式启动过应用，先删除旧进程再重启：

pm2 delete <你的应用名称/ID>

其他可能的遗漏操作 #

1. 检查ecosystem.config.js格式是否正确
   确保env字段层级正确，示例如下：

module.exports = {
  apps : [{
    name: "你的应用名称",
    script: "./app.js", // 需指向你的Node.js入口文件
    env: {
      NODE_ENV: "production",
      OAUTH_EMAIL: "your-email@example.com"
    }
  }]
};

注意不要写错字段名（比如把env写成environment），也不要把env放在apps数组外部。

2. 强制PM2加载最新配置
   修改配置文件后，不要仅用普通重启，建议用重载命令强制更新环境变量：

pm2 reload ecosystem.config.js --update-env

或删除旧进程后重新启动，避免缓存旧配置。

3. 确认是否指定了目标环境
   如果配置了env_production这类特定环境的字段，启动时需明确指定环境：

pm2 start ecosystem.config.js --env production

否则PM2只会加载默认的env字段。

4. 排查Cloudpanel环境冲突
   Cloudpanel自身可能有环境变量设置项，检查是否存在同名变量覆盖PM2配置，或Cloudpanel的应用配置是否与PM2配置冲突。

5. 验证PM2是否成功注入变量
   启动应用后，用以下命令查看PM2为应用注入的环境变量：

pm2 show <你的应用名称>

在输出的env vars部分确认是否存在OAUTH_EMAIL。如果这里有但应用读取不到，需检查应用内逻辑（比如读取变量的代码是否在dotenv.config()之前，服务器环境建议注释掉dotenv.config()，避免本地.env文件干扰）。

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