pm2启动后进程立刻退出的主因是ecosystem.config.js中script路径错误、文件不存在或无读取权限;应使用绝对路径、确认node.js在path中、设置文件可读权限,并检查package.json和scripts.start有效性。

PM2 启动后进程立刻退出?检查 ecosystem.config.js 的 script 路径和执行权限
PM2 不是直接运行源码,而是启动一个 Node.js 进程去执行指定文件。如果 script 路径写错、文件不存在、或没读取权限,它会静默失败(pm2 list 显示 errored 或根本不出现在列表里)。
- 用绝对路径写
script,比如/home/user/app/index.js,避免相对路径在不同工作目录下失效 - 确认 Node.js 可执行文件在 PATH 中,或显式指定
exec_interpreter: '/usr/bin/node' - 确保目标 JS 文件有可读权限:
chmod +r index.js;如果是用npm start启动,还要保证package.json存在且scripts.start有效 - 常见错误信息:
Script not found、Cannot find module、Permission denied—— 全部指向路径或权限问题
用 pm2 start 还是 pm2 start ecosystem.config.js?看部署阶段
开发调试时用命令行参数快速启停没问题;但上生产必须用配置文件,否则环境变量、日志路径、集群模式等全靠记忆或临时拼写,极易出错。
-
pm2 start index.js --name "myapp" --env production:适合本地验证,参数一多就难维护 -
pm2 start ecosystem.config.js --env production:所有参数收拢到 JS 或 YAML 配置里,支持多环境(--env staging)、自动重启策略、日志轮转 - 配置中
instances: 'max'表示按 CPU 核数起进程,但若应用本身是单线程且没做负载均衡,开多实例反而导致端口冲突——得配合loadBalancer: 'roundrobin'和反向代理用
pm2 restart 不生效?先确认你操作的是哪个进程 ID 或名字
PM2 默认给每个进程分配数字 ID,但重启时若只写 pm2 restart 0,而实际进程已重载、ID 变了,就会报 Process not found。更稳妥的方式永远用名字或配置文件名。
- 启动时加
--name "api",之后统一用pm2 restart api - 用配置文件启动后,直接
pm2 restart ecosystem.config.js,它会按配置里name字段识别并更新 - 别依赖
pm2 reload all:它对非 cluster 模式的进程只是 stop + start,可能丢连接;reload真正生效的前提是代码支持热重载(比如 Express +pm2-intercom),否则和restart没区别
日志打不出来、查不到?默认路径和实时查看方式要分清
PM2 把 stdout/stderr 自动重定向到自己的日志系统,不是直接输出到终端。不主动查,就以为“没日志”。
- 所有日志默认存在
~/.pm2/logs/下,按app-name-out.log和app-name-error.log分离 - 实时看日志用
pm2 logs app-name,加--lines 100控制初始行数;想看某一个进程的 error 日志:pm2 logs app-name --err - 注意
pm2 flush会清空所有日志缓冲,误操作后就真没了——线上环境慎用 - 如果 Node.js 应用自己调用了
process.exit()或抛出未捕获异常,PM2 默认会重启进程,但错误堆栈只出现在-error.log里,不进pm2 show的 “status” 字段










