必须按真实执行路径逐层验证：先确认cli环境已加载swoole扩展（90%失败根源），再检查端口是否被占、监听地址是否为0.0.0.0或内网ip、新版需强制指定swoole_base模式，最后验证task_worker_num配置是否匹配ontask回调。
遇到Swoole启动失败时，不能直接重启或重装扩展，必须按真实执行路径逐层验证：CLI环境是否加载扩展、端口是否可用、监听地址是否合法、运行模式是否匹配当前版本。每一步都可能成为阻断点。
确认CLI环境已加载Swoole扩展
这一步是90%启动失败的根源——浏览器里phpinfo()显示有swoole，不代表命令行能用。
运行 php -m | grep swoole，如果无输出，说明CLI根本没加载扩展。
执行 php --ini 查看Loaded Configuration File路径，重点检查该php.ini中是否包含 【extension=swoole.so】 这一行；若用宝塔面板，路径通常是 /www/server/php/80/etc/php.ini 或对应版本目录下的etc子目录。
别改错文件：FPM用的php.ini和CLI用的php.ini完全独立，改了网站能跑不代表命令行能跑。
检查端口与监听地址是否合法
启动时报 Address already in use，说明端口被占。
执行 sudo lsof -i :9501（把9501换成你实际用的端口），确认是否有残留进程在监听。
若查到PID，用 kill -9 PID 杀掉；若不确定，换端口测试最省事，比如改成9502，避免反复排查。
监听地址写成公网IP（如119.123.45.67）会导致Linux内核拒绝绑定，【必须用0.0.0.0或内网IP】，用 ifconfig 查本机eth0或ens33的inet地址即可。
强制指定SWOOLE_BASE模式启动
新版Swoole（v5.0+）默认不启用SWOOLE_BASE模式，而HTTP服务器依赖该模式调度，否则进程启动后立刻退出或卡死。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
第一步：修改服务初始化代码，在构造参数末尾显式传入常量：
$http = new swoole_http_server("0.0.0.0", 9501, SWOOLE_BASE);
第二步：确认未误启HTTPS配置——没配证书却开启SSL选项，会导致握手阶段静默失败，浏览器pending无响应。
第三步：telnet本地端口验证通路：telnet 127.0.0.1 9501，能连上说明服务已真正监听，连不上则问题仍在前两步。
验证task_worker_num配置是否合规
如果设置了 task_worker_num 但没定义 onTask 回调，Swoole会直接报错退出，提示 onTask is null。
方法一：临时注释掉所有task相关配置，只保留基础HTTP服务，看能否启动成功。
方法二：保留task配置，但必须同时注册回调：
$server->on('task', function ($server, $taskId, $workerId, $data) { /* 任务逻辑 */ });
注意：task_worker_num必须大于0才生效，设为0等于关闭task功能，此时再配onTask也无效。
