You need to enable JavaScript to run this app. 从npm迁移至Yarn PNP后如何以PM2集群模式运行NestJS服务
优惠活动
大模型
产品
解决方案
定价
更多

从npm迁移至Yarn PNP后如何以PM2集群模式运行NestJS服务

项目适配背景

数月前团队的Monorepo项目因node_modules目录膨胀至20万个包,迁移使用Yarn2(PnPify)方案后,全量包构建与部署总时长从40分钟压缩至4-5分钟,效率提升显著。前端包可通过tree-shaking打包为小型制品上传至存储容器,流程十分顺畅;但后端的NestJS REST、GraphQL服务需要在PM2集群模式下运行时,遇到了较多适配问题:

  • PM2支持以fork或cluster模式运行应用,当多个进程需要监听同一端口时,必须使用cluster模式——fork模式下第一个进程启动后,其余进程必然会报端口占用错误,属于正常逻辑。
  • 由于使用Yarn2的PnP模式,必须通过yarn node ./build/main.js执行才能获得正确的模块解析能力,原生Node运行时无法识别PNP的模块结构。
  • 核心矛盾:PM2集群模式要求直接使用Node作为解释器,不能以yarn/npm作为启动入口。团队最初尝试配置ecosystem.config.js如下:
{
    "apps": [
        {
            "args": "node ./build/main.js",
            "exec_mode": "cluster",
            "instances": "max",
            "interpreter": "bash",
            "name": "api",
            "script": "yarn",
            "time": true
        }
    ]
}

将该配置部署到多核虚拟机并热加载PM2服务后,监控状态全程显示应用正常,但实际只有1个进程在监听3000端口,其余进程均抛出EADDRINUSE错误。经排查发现,yarn是通过发射错误事件而非触发进程异常退出,因此PM2会误判所有进程处于存活状态。

  • 额外限制:对NestJS应用做整体打包的方案并不可行,可参考已知项目bundled-nest的相关问题说明。团队目前的临时实现方案是在NestJS内部基于Node原生cluster模块实现集群逻辑,核心代码如下:
import { Injectable } from '@nestjs/common';
import { fork, isMaster, on } from 'cluster';
import * as os from 'os';

const numCPUs = os.cpus().length;

@Injectable()
export class ClusterService {
  static clusterize(callback: Function): void {
    if (isMaster) {
      for (let i = 0; i < numCPUs; i++) {
        fork();
      }

      on('exit', (worker, code) => {
        fork();
        console.log(
          `[Cluster] worker[${worker.process.pid}] died with status: [${code}], creating new worker`,
        );
      });
    } else {
      callback();
    }
  }
}

该方案需要配合单实例模式运行PM2,实现逻辑较为冗余,无法发挥PM2本身成熟的集群管理能力。

针对性问题解法

1. Yarn2导出标准node_modules的实现方式

可直接使用Yarn2内置的链接器配置实现:

  • 在项目根目录的.yarnrc.yml中添加配置 nodeLinker: node-modules,执行yarn install后,会按照传统npm/yarn1的目录结构生成标准node_modules文件夹,完全支持原生Node运行时解析依赖,无需通过yarn命令启动。
  • 如果需要保留PnP的本地开发速度优势,可在CI流程中单独生成导出版的依赖目录,不会破坏本地开发环境的PnP运行体验。

2. PM2集群模式适配Yarn PnP的方案

本质是绕开外层yarn进程的事件误判问题,直接将PnP的模块解析能力注入Node运行时:

  • 无需将interpreter设置为bash调用yarn,Yarn2会在项目根目录生成.pnp.cjs文件,直接将该文件作为Node的预加载参数即可达到与yarn node完全一致的模块解析效果,对应ecosystem.config.js调整为:
{
    "apps": [
        {
            "exec_mode": "cluster",
            "instances": "max",
            "interpreter": "node", // 直接使用原生Node作为解释器
            "node_args": ["--require", "./.pnp.cjs"], // 提前加载PnP解析逻辑
            "script": "./build/main.js",
            "name": "api",
            "time": true
        }
    ]
}
  • 该配置下PM2的集群主进程会直接拉起多个Node子进程,自动处理端口共享逻辑,完全避免外层yarn进程的状态误判问题。

3. Yarn2异常退出逻辑的调整方式

不需要修改Yarn2源码,在应用入口最顶部添加全局错误捕获逻辑即可:

  • 对未捕获的Promise rejection、同步异常事件绑定监听,捕获到非预期错误时直接调用process.exit(1)触发进程退出,避免yarn进程仅发射错误事件不退出的问题。
  • 对应入口核心逻辑示例:
// main.ts 最顶部
process.on('unhandledRejection', (err) => {
  console.error('未捕获的Promise异常', err);
  process.exit(1);
});
process.on('uncaughtException', (err) => {
  console.error('未捕获的同步异常', err);
  process.exit(1);
});
// 后续NestJS初始化逻辑...

4. GitLab CI流程的优化方案

无需放弃Yarn2的性能优势,通过缓存策略即可兼顾构建速度与部署兼容性:

  • CI流程中仍然使用Yarn2的node-modules链接模式,利用Yarn2的并行安装、全局缓存能力,将已下载的依赖缓存到GitLab Runner的缓存目录中,安装速度与PnP模式无明显差异,不会回到传统npm 40分钟的安装时长。
  • 构建完成后直接将生成的标准node_modules目录与打包后的build产物一起部署到服务器,直接使用原生Node作为PM2解释器启动即可,不需要额外的yarn运行时依赖。
  • 如需压缩制品体积,可通过Yarn2的yarn unplug命令将生产依赖单独解压为可直接运行的目录结构,无需上传全量devDependencies包,进一步缩小部署文件体积。

内容的提问来源于stack exchange,提问作者Martijn vW

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 23:45:06