ThinkPHP 的数据库连接默认不自动重试，仅在查询中断（如 MySQL gone away）且 break_reconnect=true 时静默重试一次；连接建立失败或事务中不生效，需业务层捕获异常手动处理。
数据库连接异常时 think\db\Connection 不会自动重试？
默认情况下，ThinkPHP 的数据库连接在首次执行 SQL 失败（如连接超时、MySQL 服务重启）后，query 或 execute 会直接抛出 PDOException，不会尝试重建连接。这不是 Bug，而是设计使然：连接对象复用、事务上下文需明确控制，盲目重连可能破坏一致性。
实操建议：
- 不要依赖“自动重连”，ThinkPHP 没有开启即生效的全局重连开关
- 若需重试逻辑，应在业务层捕获
PDOException，判断错误码（如HY000/2006/2013），再手动调用$db->close()+ 重新触发查询 - 避免在事务中做重试 ——
beginTransaction()后连接断开，rollback()可能也失败，应优先保障事务原子性而非可用性
配置 break_reconnect 真的有用吗？
该配置项仅在「查询过程中连接意外中断」（比如 MySQL 主动 kill 连接、网络闪断）时起作用，且只对非事务查询生效。它不是重连开关，而是决定是否在中断后抛出异常（break_reconnect=false）还是静默重试一次（break_reconnect=true）。
常见误解与实际行为：
立即学习“PHP免费学习笔记（深入）”；
-
'break_reconnect' => true不等于“自动重连”，它只在 PDO 报错SQLSTATE[HY000] [2006] MySQL server has gone away时，内部调用connect()重建连接并重试当前语句 —— 仅一次，不递归 - 若重试仍失败（如 MySQL 没起来），依然抛异常，不会循环重试
- 该配置对连接建立阶段失败（如
Connection refused）完全无效 —— 那是初始化阶段，break_reconnect根本没机会触发 - 推荐值：
true（线上环境），但必须配合监控告警，不能当作容错兜底
如何让模型/查询构造器在连接失败时主动重建连接？
ThinkPHP 的 Query 和模型底层都依赖 Connection 实例，而实例默认是单例且长连接。要实现“按需重建”，关键是打破连接复用，或在异常后强制刷新连接引用。
可行方案：
- 在
app\common.php中定义一个封装函数，例如safeDbQuery($callable)，内部 try/catch +Db::connect()->close()+ 重执行 - 重写模型基类的
__call，对select/find等方法做统一异常拦截（注意避开save等写操作） - 使用中间件拦截 DB 异常（需结合
think\exception\Handle自定义处理），但无法区分是连接问题还是 SQL 语法错误，慎用 - 更轻量做法：在关键接口开头加
Db::query('SELECT 1')探活，失败则Db::connect()->close()，后续操作自然走新连接
生产环境必须检查的三项配置
很多“重连失效”问题其实源于基础配置不合理，和重连逻辑无关。
-
'deploy' => 0：确认未开启读写分离（deploy=1时连接管理更复杂，break_reconnect行为不一致） -
'params' => [\PDO::ATTR_TIMEOUT => 2]：设置 PDO 连接超时，避免卡死在connect()；同时配'resultset_type' => 'collection'减少内存泄漏风险 -
'dsn' => 'mysql:host=xxx;port=3306;charset=utf8mb4;unix_socket=/tmp/mysql.sock'：若用 socket 连接，确保路径存在且 PHP 进程有权限 —— 此类错误常被误判为“重连失败”，实则是根本连不上
重连只是障眼法，真正关键的是让连接失败可感知、可定位、不掩盖底层问题。线上最稳妥的做法，永远是“快速失败 + 明确日志 + 告警介入”，而不是靠多试几次蒙混过关。
