Worker exit 错误主因是opcache引发status 139段错误、pcntl/posix等关键函数被禁用、端口冲突、PHP扩展缺失或pid目录权限不足，需依次禁用opcache、检查disable_functions、验证端口与IP、确认PHP版本及扩展启用状态、修复runtime目录权限。
如果您尝试启动 Webman 应用，但 Worker 进程意外退出并报错“Worker exit”，则可能是由于环境依赖缺失、配置冲突或 PHP 扩展异常所致。以下是针对该问题的多种检测与修复方法：
一、禁用 opcache 模块以规避段错误
Webman 在 PHP 8.1+ 环境下出现 status 139 退出，常由 opcache 的 JIT 编译引发内存访问异常导致。禁用 opcache 可绕过该底层冲突。
1、运行 php --ini 查找当前生效的 php.ini 路径。
2、使用文本编辑器打开该 php.ini 文件。
3、定位到 [opcache] 区块，将所有 opcache 相关行注释掉，包括：
;opcache.enable=1
;opcache.enable_cli=1
;zend_extension=opcache
4、保存文件后，执行 php -m | grep opcache，确认输出为空。
5、重启 Webman 服务验证是否仍出现 exit with status 139。
二、检查并修复被禁用的关键 PHP 函数
Webman 启动依赖 pcntl、posix 及 socket 相关函数，若这些函数被禁用，Worker 将无法创建子进程或监听套接字，直接退出。
1、运行 php -i | grep "disable_functions" 查看禁用函数列表。
2、确认以下函数未出现在禁用列表中：pcntl_fork, pcntl_signal, pcntl_alarm, pcntl_signal_dispatch, pcntl_waitpid, putenv, exec, system, shell_exec, stream_socket_server。
3、若存在上述任一函数，编辑 php.ini 中的 disable_functions 行，将其删除或整行注释。
4、保存后执行 php -v 验证无警告，并重启 Webman。
三、验证端口绑定与网络地址配置
Worker 启动时若因地址不可分配或端口被占而失败，会提前退出且不输出完整日志；需确认监听 IP 与端口处于可用状态。
1、检查启动脚本中 Worker 构造参数，确保监听地址为 0.0.0.0 或本机实际网卡 IP（非云厂商公网 IP）。
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
2、运行 netstat -tuln | grep :端口号，确认目标端口未被其他进程占用。
3、若端口已被占用，执行 lsof -i :端口号 获取 PID，再用 kill -9 PID 终止冲突进程。
4、若使用小于 1024 的端口（如 80、443），须以 root 权限启动，或改用 ≥1024 的端口（如 8787）。
四、校验 PHP 版本与扩展兼容性
Webman v1.5.7 要求 PHP ≥7.4 且必须启用 pcntl、posix、sockets 扩展；版本或扩展缺失将导致 Worker 初始化失败后静默退出。
1、运行 php -v 确认版本不低于 7.4，推荐使用 8.0–8.2 稳定分支。
2、执行 php -m | grep -E "(pcntl|posix|sockets)"，确保三项均在输出中。
3、若缺失任一扩展，根据系统安装对应包：Ubuntu/Debian 执行 apt install php-pcntl php-posix php-sockets；CentOS/RHEL 使用 yum install php-process php-common 并确认 php.ini 中已启用。
4、修改后重启 PHP-FPM 或 CLI 环境，再次启动 Webman。
五、排查临时目录与 PID 文件权限问题
旧版 Webman 默认将 pid 文件写入 /tmp，若该目录被清理或无写入权限，主进程无法记录 PID，后续启动判定为冲突而退出。
1、检查 Webman 启动脚本中是否显式设置了 $worker->pidFile = __DIR__ . '/storage/runtime/webman.pid';。
2、确认目标路径所在目录存在且 Webman 运行用户（如 www-data 或 root）具有读写权限。
3、手动创建目录并赋权：mkdir -p storage/runtime && chmod 755 storage/runtime。
4、清除残留进程：ps aux | grep start.php | grep -v grep | awk '{print $2}' | xargs kill -9。
5、重新执行启动命令，观察是否生成新 pid 文件并持续运行。
