讲师中心 微信公众号
AI工具推荐 视频效率加速

为什么Workerman启动后马上就退出了?排查思路

梦墨君_4869

梦墨君_4869

发布时间:2026-05-22 22:30:23

|

1011人浏览过

|

来源于php中文网

原创

根本原因是Workerman默认以前台模式运行,php start.php start启动后终端关闭即退出;必须加-d参数启用守护进程,且pidFile需设为可写绝对路径,否则静默失败。

为什么workerman启动后马上就退出了?排查思路

php start.php start 启动后立即退出,根本原因是前台模式

Workerman 默认不 daemonize,php start.php start 启动的是前台进程,终端关闭或 SSH 断开,父进程收到 SIGHUP,整个进程树就结束了。这不是异常,是设计使然。

必须加 -d 参数才能 fork 出后台守护进程:php start.php start -d。但注意:它不会报错告诉你失败了——如果 $worker->pidFile 路径不可写、不是绝对路径、或目录不存在,-d 会静默失败,进程启动几秒后自动退出,看起来“刚启就挂”。

  • $worker->pidFile 必须设为绝对路径,例如 /var/run/workerman.pid,不能用 workerman.pid 这类相对路径
  • 确保运行用户(如 www-data)对 pidFile 所在目录有写权限,mkdir -p /var/run && chown www-data:www-data /var/run
  • 别用 nohup php start.php start & —— Workerman 没处理 SIGHUP,子进程仍可能被中断

exit with status 256 是 PHP 崩溃,不是 Workerman 问题

看到日志里有 exit with status 256,基本等于 PHP 子进程发生了致命错误(如调用禁用函数、扩展段错误),内核强制终止,返回状态码 256(即信号 1 的等效值)。

最该先跑的命令是:curl -Ss http://www.workerman.net/check.php | php。它会明确指出哪些必需函数被 disable_functions 拦住了,比如 pcntl_fork、posix_kill —— 这两个一被禁,master 就无法管理 worker,必然闪退。

  • 检查禁用函数:php -i | grep disable_functions
  • 确认关键扩展已启用:php -m | grep -E "pcntl|posix|sockets"
  • 临时开启全量错误输出:在 start.php 开头加 ini_set('display_errors', 'on'); error_reporting(E_ALL);,否则 fatal 错误完全不落地

Supervisor 下报 FATAL 或反复重启,其实是启动失败三次以上

Supervisor 日志里出现 gave up: workerman entered FATAL state, too many start retries too quickly,说明 Workerman 主进程连续三次启动都失败了(比如配置语法错、端口被占、权限不足),Supervisor 主动放弃,不是 Supervisor 故障。

关键点在于 Supervisor 的 command 必须带 -d,且不能漏掉 stopasgroup=true 和 killasgroup=true —— 否则 supervisorctl stop 只杀主进程,worker 子进程变僵尸,下次启动时端口被占,又失败,形成死循环。

  • command=/usr/bin/php /path/to/start.php start -d —— 缺 -d 就注定失败
  • 务必设 user=www-data(和 PHP 实际运行用户一致),避免日志/ pid 写入失败
  • redirect_stderr=true + stdout_logfile= 必开,否则 PHP warning/fatal 全丢进黑洞

Windows 下双击 workerman.bat 闪退,大概率是环境变量没配好

Windows 用户双击 workerman.bat 窗口一闪而过,90% 是系统找不到 php 命令。不是 Workerman 问题,是 PATH 没把 PHP 目录加进去。

打开 CMD,执行 php -v,如果提示“不是内部或外部命令”,就证实了这点。必须把 PHP 安装目录(如 C:\php)加到系统环境变量 PATH 中,再重新打开 CMD 验证。

  • 别依赖 bat 文件里写死的 php 路径(如 "C:\php\php.exe"),容易因版本升级失效
  • 确保用的是 CLI 版本的 PHP(php -v 输出含 cli),而不是 Apache 或 Nginx 模块版
  • PHP 版本至少 7.1+,低于此版本 Workerman 3.x 无法运行
Workerman 启动即退,表面看是命令没加 -d,深层往往是权限、禁用函数、路径、环境变量这些“基础设施”没对齐。最容易被忽略的是:-d 失败不报错,disable_functions 拦了关键函数也不提示,它们共同制造了“莫名其妙就没了”的假象。

热门AI工具

更多
蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

相关专题

更多
Workerman安装配置教程
Workerman安装配置教程

Workerman安装配置教程专题提供Workerman安装配置、WebSocket开发、TCP通信、异步编程、高并发服务搭建与PHP实时通信开发教程。

166

2026.05.20

Workerman实时通信与长连接开发教程
Workerman实时通信与长连接开发教程

WWorkerman实时通信与长连接开发教程聚合实时通信、聊天室、长连接、消息推送、AI流式输出等Workerman高并发开发内容。

202

2026.05.20

Workerman异步通信与TCP服务器开发
Workerman异步通信与TCP服务器开发

Workerman异步通信与TCP服务器开发专题整理Workerman异步通信、TCP服务、HTTP服务、WebSocket开发与高并发PHP服务器教程。

187

2026.05.20

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

80

2026.09.30

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

80

2026.09.30

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

80

2026.09.30

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

40

2026.09.30

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

60

2026.09.29

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

280

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Webman中文手册
Webman中文手册

共0课时 | 0人学习

Workerman官方手册
Workerman官方手册

共0课时 | 0人学习

ThinkPHP5.1完全开发手册
ThinkPHP5.1完全开发手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn