Node.js应用Docker镜像用node server.js正常，pm2-runtime运行异常求助

1. 确认工作目录匹配 #

Docker容器内的工作目录如果和pm2-runtime启动路径不对应，会找不到server.js文件。

• 检查Dockerfile中的WORKDIR指令，比如是否设置为WORKDIR /app
• 启动时要么确保在工作目录下执行命令，要么指定server.js的完整路径：pm2-runtime /app/server.js

2. 验证环境变量一致性 #

node server.js能正常加载的环境变量，pm2-runtime可能没正确读取。

• 对比两种启动方式下的环境变量：在启动命令前加env && ，比如env && pm2-runtime server.js，和env && node server.js的输出做对比，找出差异项
• 确保Dockerfile里的ENV指令或启动容器时传递的环境变量在pm2启动时生效

3. 查看pm2日志定位错误 #

pm2的日志是排查问题的关键，不要忽略日志输出：

• 如果容器还在运行，进入容器执行pm2 logs查看实时日志
• 如果容器启动后直接退出，修改启动命令为pm2-runtime server.js --no-daemon，这样能在docker logs <容器ID>里看到详细错误信息

4. 检查pm2-runtime安装路径 #

确保pm2-runtime的安装路径正确，能被Docker容器找到：

• 全局安装的话，Dockerfile里必须有npm install pm2 -g，并且确认PATH环境变量包含全局node_modules的bin目录（一般默认包含，但最好检查）
• 本地项目依赖安装的话，启动命令要使用本地路径：./node_modules/.bin/pm2-runtime server.js

5. 核对pm2配置文件（若使用） #

如果用了pm2的配置文件（如ecosystem.config.js），要确保配置项正确：

• 示例正确配置：

  module.exports = {
    apps: [{
      name: 'my-node-app',
      script: './server.js',
      env: {
        NODE_ENV: 'production'
      }
    }]
  };
  

• 启动时指定配置文件：pm2-runtime start ecosystem.config.js

6. 修正Docker信号传递方式 #

pm2-runtime需要正确接收Docker的停止信号，否则可能启动异常或无法正常退出：

• 避免用shell包裹启动命令，比如不要写CMD ["sh", "-c", "pm2-runtime server.js"]
• 改用exec形式的CMD：CMD ["pm2-runtime", "server.js"]，这样信号能直接传递给pm2进程

内容的提问来源于stack exchange，提问作者Sabreen Salama