在宝塔面板中为Swoole配置心跳检测需三步：确认Swoole扩展已启用并版本≥4.8.0；手动编辑php.ini或swoole.ini添加heartbeat_check_interval=30和heartbeat_idle_time=90；在Server代码set()中显式设置并验证onClose日志。
在宝塔面板中为Swoole扩展配置心跳检测，是解决WebSocket或TCP长连接频繁断开、FD堆积、服务端无法及时感知客户端掉线的核心操作。不设置或参数错配会导致连接空闲12分钟后被NAT设备静默回收，而服务端仍保留无效fd，最终触发文件描述符耗尽或内存泄漏。
确认Swoole扩展已正确安装并启用
进入宝塔面板 → 软件商店 → 搜索“Swoole” → 点击已安装的PHP版本对应Swoole扩展 → 查看状态是否为“已启用”。若显示“未安装”或“禁用”，需先勾选对应PHP版本并点击“安装”或“启用”。【必须确保PHP进程重启后Swoole模块加载成功，可通过php -m | grep swoole验证】
执行命令 php -r "echo Swoole\VERSION;"，输出版本号（如5.0.3）即表示扩展可用。低于4.8.0的版本不支持heartbeat_check_interval参数，强制设置将被忽略。
在宝塔中修改PHP配置文件注入Swoole心跳参数
宝塔不提供图形化界面直接配置Swoole心跳，必须手动编辑PHP的swoole.ini或主php.ini文件：
路径一（推荐）：宝塔面板 → PHP管理 → 对应PHP版本 → 配置文件 → 找到以“;swoole”开头的区块，在其下方新增两行：
extension=swoole.so
swow.swoole.heartbeat_check_interval=30
swow.swoole.heartbeat_idle_time=90
路径二（兼容旧版）：若上述路径无swoole配置区块，则在文件末尾追加：
extension=swoole.so
swoole.heartbeat_check_interval=30
swoole.heartbeat_idle_time=90
【注意：swoole.heartbeat_check_interval必须为正整数且≤heartbeat_idle_time的1/2，设为30配合90是安全阈值；只写heartbeat_idle_time无效】
重启PHP服务并验证配置生效
步骤一：返回宝塔PHP管理页 → 点击“重载配置”按钮 → 等待提示“重载成功”
步骤二：SSH登录服务器，执行以下命令验证参数是否写入运行时：
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
php -r "var_dump(ini_get('swoole.heartbeat_check_interval'), ini_get('swoole.heartbeat_idle_time'));"
输出应为string(2) "30" 和 string(2) "90"。若返回false或空字符串，说明配置未加载，需检查ini文件路径是否被宝塔多版本PHP配置覆盖，或确认是否误写成swow.swoole.*（仅Swoole 5.0+支持swow前缀）。
在Swoole Server代码中显式调用set方法（双重保险）
方法一：在创建Server实例后、start()之前，硬编码设置参数：
$server = new Swoole\WebSocket\Server("0.0.0.0", 9501);
$server->set([
'heartbeat_check_interval' => 30,
'heartbeat_idle_time' => 90,
]);
方法二：从环境变量读取（便于宝塔部署时统一管理）：
$server->set([
'heartbeat_check_interval' => (int)getenv('SWOOLE_HEARTBEAT_CHECK') ?: 30,
'heartbeat_idle_time' => (int)getenv('SWOOLE_HEARTBEAT_IDLE') ?: 90,
]);
此时需在宝塔PHP项目根目录的.env文件中添加：
SWOOLE_HEARTBEAT_CHECK=30
SWOOLE_HEARTBEAT_IDLE=90
这一步可绕过ini配置失败风险，确保服务启动时心跳逻辑必然生效。
观察onClose事件确认心跳清理是否触发
在onClose回调中加入日志记录：
$server->on('close', function ($server, $fd, $reactor_id) {
$info = $server->connection_info($fd);
if ($info === false && $reactor_id === -1) {
file_put_contents('/www/wwwroot/yourapp/logs/heartbeat_kick.log', date('Y-m-d H:i:s') . " fd={$fd} 被心跳机制踢出\n", FILE_APPEND);
}
});
等待客户端静默1.5分钟（略超90秒），检查log文件是否生成对应记录。若无记录，说明心跳未启动——立即回查heartbeat_check_interval是否为正整数、PHP进程是否真正重启、代码中set()是否被错误地放在start()之后。
