Google Cloud上Node.js的pm2持续重启问题排查与解决

一、核心原因分析 #

1. vizion模块分析失败
   pm2的vizion模块会尝试读取代码目录的版本控制（如.git）信息，但Cloud Build构建后的容器通常不会保留.git目录，直接触发Error vizion::analyze() for given folder错误，进而引发pm2内部异常。

2. pm2与Cloud Run环境不兼容

• 你使用的--no-daemon参数让pm2在前台运行，但pm2的worker进程逻辑会周期性输出[PM2][WORKER] My job here is done, next job in 30 seconds，结合vizion模块的错误，导致进程陷入无意义的重启循环。
• Cloud Run的文件系统是临时且受权限限制的，pm2需要创建socket文件进行进程通信，这类限制会引发ENOENT类的socket连接错误。

二、解决方案 #

方案1：直接运行Node进程（推荐） #

Cloud Run原生支持进程崩溃自动重启，完全不需要pm2实现该能力。将启动命令改为：

node /home/app/host/code/index.js

这是Cloud Run的标准运行方式，避免pm2带来的额外复杂度。

方案2：如果一定要用pm2（不推荐） #

调整pm2的启动参数与配置，适配容器环境：

1. 使用pm2-runtime替代pm2 start：这是pm2专门为容器场景设计的运行时，会保持前台运行并正确处理容器信号。
2. 禁用vizion模块，避免版本控制目录检查错误。
   修改后的启动命令：

pnpm pm2-runtime start --name myorganization --no-vizion /home/app/host/code/index.js

也可以创建ecosystem.config.js配置文件，明确禁用不必要的功能：

module.exports = {
  apps: [{
    name: 'myorganization',
    script: '/home/app/host/code/index.js',
    vizion: false,
    watch: false,
    autorestart: true
  }]
};

然后用命令启动：pnpm pm2-runtime start ecosystem.config.js

三、关于疑问的解答 #

1. --no-daemon是否仅适用于本地开发？
   --no-daemon的作用是让pm2在前台运行，并非仅局限于本地开发，但在容器或无服务器环境中，更适合用pm2专门的pm2-runtime来托管进程，而非pm2 start --no-daemon。

2. Cloud Run是否需要pm2？
   完全不需要。Cloud Run本身会监控主进程：一旦进程崩溃，Cloud Run会自动重启整个容器实例，实现你需要的“进程崩溃自动重启”能力。此外，Cloud Run的单实例单进程模型和pm2的多进程管理逻辑冲突，反而会引入不必要的问题。

内容的提问来源于stack exchange，提问作者Lance Pollard