PM2集群模式下运行Express应用的Yarn PnP解决方案

在使用PM2管理Node.js应用时，集群模式(Cluster Mode)是一个常用的功能，它能够充分利用多核CPU的优势。然而，当结合Yarn PnP(Plug'n'Play)包管理工具时，开发者可能会遇到一些特殊问题。

问题现象

在Yarn PnP环境下，使用PM2集群模式启动Express应用时，会出现端口冲突(EADDRINUSE)错误。这是因为PM2尝试启动多个实例时，第二个实例无法绑定到同一个端口上。

问题根源

这个问题的根本原因在于启动方式的选择。当通过yarn start命令间接启动应用时，PM2无法正确地为每个工作进程分配独立的端口。此外，Yarn PnP的特殊模块解析机制也需要特殊处理。

解决方案

直接运行应用脚本

正确的做法是直接运行应用的主脚本文件(index.js)，而不是通过yarn命令间接启动。在PM2的配置文件中，应该这样设置：

module.exports = {
    apps: [
        {
            name: "your-app-name",
            script: "index.js",  // 直接指向应用入口文件
            interpreter_args: "--require ./.pnp.cjs --loader ./.pnp.loader.mjs",
            instances: 2,
            exec_mode: "cluster"
        }
    ]
}

Yarn PnP的特殊配置

对于使用Yarn PnP的项目，还需要注意以下几点：

1. 确保.yarnrc.yml文件中设置了enableGlobalCache: false，强制使用项目本地缓存
2. 在修改配置后，需要重新安装依赖项(yarn install)，使依赖包进入项目本地缓存

技术原理

PM2的集群模式实际上是通过Node.js的cluster模块实现的。当配置了多个实例时，PM2会创建一个主进程和多个工作进程。每个工作进程都需要能够独立启动应用。

Yarn PnP通过.pnp.cjs和.pnp.loader.mjs文件实现了特殊的模块解析机制。在直接运行脚本时，需要通过--require和--loader参数显式地加载这些文件，否则Node.js无法正确解析依赖关系。

最佳实践

1. 对于新项目，建议在项目初期就测试PM2集群模式的配置
2. 在开发环境中使用与生产环境相同的PM2配置，尽早发现问题
3. 考虑使用环境变量来动态设置端口号，增加配置的灵活性
4. 对于复杂的应用，可以实现端口自动分配或重试机制

总结

PM2与Yarn PnP的结合使用确实需要特别注意配置方式。通过直接运行应用脚本并正确配置Yarn PnP的加载机制，可以解决集群模式下的端口冲突问题。这种配置方式不仅适用于Express应用，也适用于其他Node.js框架。

理解PM2集群模式的工作原理和Yarn PnP的模块解析机制，有助于开发者更好地调试和优化生产环境下的Node.js应用部署。