thinkphp数据库连接超时重试需分五步配置：第一步设dsn中connect_timeout=3防建连卡顿；第二步params中pdo::attr_timeout=3控sql执行超时；第三步tp6.1+在pool下配get_timeout=1000控取连接等待；第四步break_reconnect=true须配pdo::attr_errmode=exception才生效；第五步cli/队列场景需手动保活或捕获2006错误重连。
ThinkPHP数据库连接超时重试不是配个参数就能自动生效的机制，必须分清“连不上”和“连上了但断了”两类问题，再对应配置建连超时、查询超时、连接获取超时和重连逻辑——漏掉任一环，都会卡住或静默失败。
第一步：解决“根本连不上”的卡顿（TCP建连超时）
这是最常被忽略的环节。默认不设 connect_timeout，Linux 下会傻等 75 秒，Windows 约 30 秒，期间页面完全无响应。
- 把数据库配置中的 hostname 改成 IP 地址，例如
'hostname' => '192.168.1.100'，绕过 DNS 解析 - 在 DSN 字符串里显式加上
;connect_timeout=3，完整示例：mysql:host=192.168.1.100;port=3306;dbname=test;connect_timeout=3 - 注意：该参数仅在 PHP 8.1+ 且 ThinkPHP 6.1+（配合 think-orm v3.0+）才真正透传；若用 mysqlnd 驱动，需实测验证是否生效
第二步：控制“连上后执行 SQL 卡住”的时间（查询执行超时）
PDO::ATTR_TIMEOUT 不影响建连，只管连接建立后发 SQL 到返回结果之间的等待上限，比如锁表、大字段遍历、慢查询等场景。
- 在数据库配置的
params数组中加入：'params' => [\PDO::ATTR_TIMEOUT => 3]，单位是秒 - 别写成
'timeout' => 3或'connect_timeout' => 3，这些字段 TP 不识别 - 此参数对语法错误、主键冲突等无效，只对网络抖动、锁等待、MySQL 响应延迟起作用
第三步：启用连接池下的“取连接等待超时”（TP6.1+ 有效）
当开启连接池后，请求可能排队等空闲连接。这时 get_timeout 才真正生效，防止线程无限等待。
- 配置必须嵌套在具体数据库项下，例如：
'mysql' => [ /* 其他配置 */, 'pool' => ['max_active' => 20, 'get_timeout' => 1000] ] -
get_timeout单位是毫秒，设为1000表示最多等 1 秒，超时抛think\exception\PDOException - 注意：
max_active是硬限制，若设得过大（如 100），而 MySQL 的max_connections只有 151，容易触发Too many connections
第四步：让断连后能自动重试（break_reconnect 生效条件）
这个选项只在查询执行过程中连接意外中断（如 MySQL server has gone away）时触发重连，但前提是底层异常能被框架捕获到。
- 必须同时配置：
'break_reconnect' => true和'params' => [\PDO::ATTR_ERRMODE => \PDO::ERRMODE_EXCEPTION] - 若
PDO::ATTR_ERRMODE是默认的SILENT或WARNING，异常不会抛出，break_reconnect形同虚设 - 事务中不支持自动重连——一旦 rollback，上下文已销毁，重连后继续执行会导致数据错乱，关键事务请手动重试
第五步：CLI 或长连接场景要额外保活
FPM 请求天然短生命周期，但 CLI 命令、Swoole 或 work 模式队列是常驻进程，空闲连接会被 MySQL 主动断开（wait_timeout 默认 8 小时），下次使用直接报错。
- 不要依赖
break_reconnect担全责，它只在查询失败时触发一次，无法预防空闲断连 - 建议封装一个保活查询函数，在关键操作前主动 ping：
if (!Db::getPdo()->getAttribute(\PDO::ATTR_CONNECTION_STATUS)) { Db::close(); Db::connect(); } - 更稳妥的做法是捕获
SQLSTATE[HY000] [2006]错误码，手动 close + connect + retry，避免依赖不可靠的 attribute 检测
不复杂但容易忽略：每个自定义数据库连接（如 Db::connect('log')）都必须单独配全 params 和 break_reconnect，全局 default 配置不会继承过去。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
