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