在PM2环境中使用dotenvx管理Node.js环境变量

dotenvx是一个强大的环境变量管理工具，相比传统的dotenv，它支持多环境文件配置。本文将详细介绍如何在PM2进程管理器中正确使用dotenvx来管理Node.js应用的环境变量。

PM2环境变量管理的特殊性

PM2作为Node.js应用的进程管理器，其环境变量注入机制与常规Node.js进程有所不同。PM2会为每个工作进程创建独立的环境，这导致直接在PM2配置中设置的环境变量可能无法按预期工作。

解决方案一：直接导入dotenvx

对于可以修改代码的项目，最直接的解决方案是在应用入口文件中直接导入并配置dotenvx：

import {config as dotenvConfig} from '@dotenvx/dotenvx';
dotenvConfig({
    path: [
        ".env",
        ".env.default",
    ]
});

这种方法确保在任何进程环境下都能正确加载环境变量，但缺点是需要修改应用代码。

解决方案二：PM2配置文件中使用dotenvx

更优雅的解决方案是在PM2的配置文件中直接使用dotenvx命令：

module.exports = {
  apps : [{
    name: 'app',
    script: 'dotenvx run --env-file=.env.production -- node ./app.js',
  }]
};

这种配置方式让PM2启动应用时通过dotenvx预先加载环境变量，然后再启动Node.js应用。

工作原理解析

当使用dotenvx run命令时，它会先加载指定的环境变量文件，然后执行后续的命令。在PM2环境中，这种方式确保了环境变量在Node.js应用启动前就已经被正确加载，即使PM2创建了新的进程环境。

最佳实践建议

1. 对于生产环境，建议明确指定环境文件，如.env.production
2. 可以配置多个环境文件，确保默认值和特定环境值都能被加载
3. 在团队协作项目中，建议将这种配置方式写入文档，确保一致性

通过以上方法，开发者可以在PM2环境中充分利用dotenvx的多环境文件支持功能，实现更灵活的环境变量管理。