ThinkPHP 的 tcp_keepalive 配置无效，因 PDO 不识别该参数；TCP keepalive 由内核参数控制，应用层应使用 ping() + reconnect() 或连接池活性检测。
ThinkPHP 的 tcp_keepalive 配置根本不起作用
ThinkPHP 数据库配置项里写 tcp_keepalive => true 是无效的。PDO 驱动（包括 MySQLi）不识别这个键，框架也不会把它透传给底层 socket。你加了它，既不会触发系统级 TCP keepalive，也不会影响连接行为——它只是被 quietly 忽略掉。
常见错误现象：配置里加了 tcp_keepalive => true，但定时任务隔 5 分钟跑一次仍报 PDOException: MySQL server has gone away；云数据库 RDS 连接频繁中断，日志里看不到任何保活探测痕迹。
原因很直接：tcp_keepalive 不是 PDO DSN 支持的参数，也不是 ThinkPHP Connection 类解析的合法配置项。它只在极少数原生 MySQL 客户端（如 mysql CLI 工具）或 C 扩展中作为 socket 层选项存在。
真正起作用的是 Linux 内核的 tcp_keepalive_* 全局参数
如果你用的是标准 PHP-FPM + MySQL（非 Swoole），TCP keepalive 行为完全由操作系统控制，和 PHP 代码无关。只要 PHP 建立的 socket 启用了 SO_KEEPALIVE（PDO 默认开启），就会受以下三个内核参数约束：
立即学习“PHP免费学习笔记（深入）”；
-
net.ipv4.tcp_keepalive_time：默认 7200 秒（2 小时），连接空闲后多久发第一个探测包 -
net.ipv4.tcp_keepalive_intvl：默认 75 秒，每次探测间隔 -
net.ipv4.tcp_keepalive_probes：默认 9 次，连续失败多少次后断连
网络抖动环境下，这三个值必须调小。例如阿里云 RDS 的 wait_timeout=300（5 分钟），你就得让探测总超时 < 300 秒，否则连接早被 MySQL 关了，TCP 层还在傻等响应。推荐临时调整：
sudo sysctl -w net.ipv4.tcp_keepalive_time=300 sudo sysctl -w net.ipv4.tcp_keepalive_intvl=15 sudo sysctl -w net.ipv4.tcp_keepalive_probes=3
这样总探测窗口是 300 + 15 × 3 = 345 秒，略大于 MySQL 的 300 秒，能覆盖大部分抖动间隙。
PHP 层唯一可控的保活动作：手动 ping() + reconnect()
ThinkPHP 的 Connection 对象提供 ping() 方法，但它不是发送 TCP 探测包，而是执行一条轻量 SQL：SELECT 1。它本质是应用层心跳，用来判断连接是否还能收发数据，和系统级 TCP keepalive 完全无关，但更可靠——因为能真实验证 MySQL 服务可用性。
实操建议只在关键入口处加，避免性能损耗：
- 命令行任务开头：
$connection->getPdo()->ping()失败则$connection->reconnect() - HTTP 请求中间件里（慎用）：捕获
PDOException中的MySQL server has gone away后重连，再重试当前查询 - 不要在每个
Db::table()->find()前都 ping——QPS 高时会把数据库打满
注意：ping() 在 PDO 上是安全的，但某些旧版 MySQLi 驱动可能不支持，需配合 method_exists($conn, 'ping') 判断。
Swoole 场景下 TCP keepalive 彻底失效
在 Swoole Worker 进程常驻模型中，PHP 进程不退出，PDO 连接对象长期复用，但 Linux 内核的 TCP keepalive 参数对「已建立但无数据交换」的 socket 生效的前提是：该 socket 仍由创建它的进程持有并处于活跃调度状态。Swoole 的协程调度、连接池管理、以及进程 fork 行为，会导致内核无法正确维护 socket 状态计时器。
此时，tcp_keepalive_time 等参数基本形同虚设。唯一靠谱的方案是应用层主动探测：
- 启用 ThinkPHP 的连接池，并设置
max_idle_time（如 60 秒），让空闲连接自动释放 - 在每次从连接池取连接前，强制执行
$connection->ping() - 禁用长连接：配置
'persistent' => false，让每次请求都新建连接（适合低频业务）
最容易被忽略的一点：Swoole + ThinkPHP 的连接池默认不校验连接活性，你看到的「可用连接」可能早已被 MySQL 主动踢出，却还在池子里躺着等下次被取走——直到报错才暴露问题。
