必须立即验证HTTP服务器响应：执行/www/server/php/80/bin/php --ri swoole确认enabled、support http server等字段齐全；新建api_test.php启动Swoole HTTP服务绑定0.0.0.0:9501，用curl和公网IP测试，失败时检查--enable-http2参数、端口放行及进程状态。
宝塔面板安装Swoole扩展后，需立即验证HTTP服务器是否能正常响应API请求，避免因配置遗漏导致WebSocket握手失败、协程函数不可用或HTTP接口返回500错误。
确认Swoole已加载且支持HTTP服务
登录服务器终端，执行以下命令验证模块状态：
【/www/server/php/80/bin/php --ri swoole】 必须使用PHP 8.0完整路径调用，否则可能检测到旧版本或CLI/FPM不一致环境。
检查输出中是否包含 enabled、version、support http server、support openssl、support http2 字样；若缺失 support http server，说明 configure 时未加 --enable-http2，后续HTTP接口将无法启动。
运行 php -m | grep swoole 只显示模块名，不能替代 --ri 验证，跳过此步易漏判功能缺失。
编写最小化HTTP服务脚本
在网站根目录（如 /www/wwwroot/test）新建文件 api_test.php，内容如下：
<?php
if (!extension_loaded('swoole')) {
exit("Swoole extension not loaded");
}
$http = new Swoole\Http\Server('0.0.0.0', 9501);
$http->on('request', function ($request, $response) {
$response->header('Content-Type', 'application/json');
$response->end(json_encode(['status' => 'ok', 'time' => time()]));
});
$http->start();
注意：不要绑定 127.0.0.1 —— 宝塔防火墙默认放行 0.0.0.0:9501，但会拦截本地回环地址对外访问；绑定 0.0.0.0 才能被 curl 或 Postman 正确访问。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
启动服务并测试接口
第一步：在终端中切换到脚本所在目录，执行：
/www/server/php/80/bin/php api_test.php &
第二步：检查进程是否存活：
ps aux | grep api_test.php 输出中应有 php 进程且无 warning 或 Fatal error。
第三步：用 curl 测试接口：
curl -v http://127.0.0.1:9501 若返回 HTTP/1.1 200 OK 及 JSON 数据，说明服务已就绪；若超时，检查宝塔安全组是否开放 9501 端口，或是否被 SELinux 限制。
第四步：从浏览器或 Postman 访问服务器公网IP+9501（如 http://192.168.1.100:9501），必须看到 JSON 响应；若提示连接被拒绝，说明宝塔面板的“安全”→“放行端口”未添加 9501。
常见失败场景快速定位
方法一：报错 Call to undefined function swoole_http_server()
原因：configure 缺少 --enable-http2 参数 → 重新编译，补上该参数再 make install。
方法二：curl 返回 empty reply from server
原因：Swoole 进程崩溃或未监听成功 → 查看终端前台输出是否有 segfault 或 extension conflict 提示；关闭所有其他占用 9501 的进程（如旧版 Swoole 实例、Node.js 服务）。
方法三：浏览器访问返回 ERR_CONNECTION_REFUSED
【不是 PHP 报错，而是网络层阻断】 → 登录宝塔面板 →「安全」→「放行端口」→ 添加 9501 →「保存」→ 再试。
