全局与本地安装pm2是否存在冲突？如何用pm2 JS API结合Sentry追踪崩溃

一、全局与本地安装PM2是否会产生冲突？ #

• 命令调用层面无直接冲突，但存在版本差异风险
  直接在终端执行pm2命令时，系统会优先使用PATH环境变量指向的全局安装版本；而在项目npm脚本（如package.json的scripts字段）中调用pm2时，npm会优先查找本地node_modules/.bin下的版本。两者调用路径不同，不会直接触发报错，但如果全局与本地版本差异较大，可能出现行为不一致（比如命令参数、进程管理逻辑不同），属于潜在的兼容性问题。

• 守护进程兼容性冲突
  PM2的核心是一个全局运行的守护进程（pm2 daemon），无论调用全局还是本地PM2，最终都会和这个守护进程通信。如果本地PM2版本与守护进程版本不兼容，会出现通信失败、进程管理异常等直接冲突。解决办法是确保全局和本地PM2版本一致，或者使用pm2 update同步守护进程版本。

二、使用PM2 JS API结合Sentry追踪崩溃 #

实现步骤 #

1. 安装依赖
   在项目中安装PM2和Sentry Node SDK：

   npm install pm2 @sentry/node
   

2. 初始化Sentry并监听PM2事件
   通过PM2的事件总线监听进程的崩溃、异常事件，将信息上报至Sentry。示例代码如下：

   const pm2 = require('pm2');
   const Sentry = require('@sentry/node');
   
   // 初始化Sentry
   Sentry.init({
     dsn: '你的Sentry项目DSN',
     environment: process.env.NODE_ENV || 'production',
     release: 'v1.0.0' // 替换为你的项目版本
   });
   
   // 连接PM2守护进程
   pm2.connect(err => {
     if (err) {
       console.error('PM2连接失败:', err);
       Sentry.captureException(err);
       process.exit(1);
     }
   
     // 启动PM2事件总线，监听进程状态
     pm2.launchBus((err, bus) => {
       if (err) {
         Sentry.captureException(err);
         return;
       }
   
       // 捕获非预期退出（崩溃）事件
       bus.on('process:exit', data => {
         if (data.exit_code !== 0) {
           const crashDetails = {
             进程名称: data.name,
             PID: data.pid,
             退出码: data.exit_code,
             时间: new Date().toISOString()
           };
           Sentry.captureMessage(`PM2进程崩溃: ${data.name}`, {
             level: 'fatal',
             extra: crashDetails
           });
         }
       });
   
       // 捕获进程未处理异常
       bus.on('process:exception', data => {
         const exceptionDetails = {
           进程名称: data.process.name,
           PID: data.process.pid,
           异常信息: data.data,
           时间: new Date().toISOString()
         };
         Sentry.captureException(data.data, {
           extra: exceptionDetails
         });
       });
     });
   
     // 启动目标应用进程
     pm2.start({
       script: 'app.js', // 你的应用入口文件
       name: 'my-application'
     }, (err, apps) => {
       if (err) {
         Sentry.captureException(err);
         pm2.disconnect();
       }
     });
   });
   
   // 程序退出时断开PM2连接
   process.on('SIGINT', () => {
     pm2.disconnect();
     process.exit(0);
   });
   

注意事项 #

• 确保本地PM2版本与API版本匹配，避免因版本差异导致事件监听失效
• Sentry的DSN必须正确配置，否则无法上报错误信息
• 可根据需求扩展监听更多PM2事件（如process:restart），完善崩溃追踪链路
• 如果管理多进程，需确保每个进程的异常都能被事件总线捕获

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