Egg.js 中获取服务启动参数的正确方式

在开发基于 Egg.js 的应用时，开发者有时会遇到需要获取服务启动参数的需求。本文将通过一个实际案例，分析为什么在 Egg.js 应用中直接获取 Node.js 启动参数会遇到问题，以及如何正确实现这一需求。

问题现象

开发者尝试在 Egg.js 应用中通过 process.argv 获取启动参数时发现：

1. 在 app.js 生命周期中完全获取不到自定义参数
2. config.local.js 内部的逻辑被执行了 4 次
3. 只有第一次能获取到正确的启动命令，后续获取到的都不正确

原因分析

这种现象的根本原因在于 Egg.js 的多进程模型。Egg.js 采用 Master-Worker 架构：

1. Master 进程负责管理 Worker 进程
2. Worker 进程才是实际执行业务逻辑的进程
3. Node.js 的启动参数默认不会从 Master 进程传递给 Worker 进程

当我们在 package.json 中配置类似 "dev": "egg-bin dev -- --load=test" 的启动命令时：

1. 只有 Master 进程能获取到完整的启动参数
2. Worker 进程启动时不会继承这些参数
3. 这就是为什么在 app.js 中获取不到参数的原因

至于 config.local.js 被执行多次的现象，是因为 Egg.js 的配置加载机制会在不同阶段多次加载配置。

解决方案

推荐方案：使用环境变量

最佳实践是使用环境变量来传递参数：

1. 修改启动命令：

"dev": "LOAD=test egg-bin dev"

2. 在代码中通过 process.env.LOAD 获取

这种方式的优势：

• 环境变量会自动传递给所有子进程
• 符合 12-Factor 应用原则
• 配置清晰，易于维护

其他方案

如果必须使用启动参数，可以考虑：

1. 在 Master 进程中捕获参数并存储
2. 通过 IPC 通信将参数传递给 Worker 进程
3. 但这种方案实现复杂，不推荐

最佳实践建议

1. 对于配置类参数，优先使用 Egg.js 的配置文件
2. 对于环境相关参数，使用环境变量
3. 避免依赖 Node.js 启动参数传递业务配置
4. 复杂的配置可以通过自定义插件机制实现

总结

理解 Egg.js 的多进程模型对于解决这类问题至关重要。在分布式系统中，进程间的参数传递需要特别注意，环境变量是最可靠和跨平台的解决方案。通过本文的分析，开发者可以避免在 Egg.js 应用中错误地依赖启动参数，而是采用更健壮的方式来实现配置传递。