启用break_reconnect配置、按环境差异化设置、手动封装重试查询、切换queue为listen模式可解决MySQL server has gone away错误。
如果您在使用ThinkPHP运行长时间任务时遇到SQLSTATE[HY000]: General error: 2006 MySQL server has gone away错误，说明数据库连接因空闲超时已被MySQL服务器主动关闭。以下是解决此问题的步骤：
一、启用break_reconnect配置项
该方法通过框架内置机制，在检测到指定错误码时自动关闭失效连接并重建新连接，适用于绝大多数CLI及Web请求场景。其生效前提是PDO异常被正确抛出，且驱动类型为pdo_mysql。
1、打开项目配置文件 config/database.php。
2、定位到目标数据库连接配置（如'mysql'键下的数组）。
立即学习“PHP免费学习笔记（深入）”；
3、确保设置 'type' => 'pdo_mysql'，不可使用mysqli或mysql。
4、将 'break_reconnect' => true 显式写入配置项中。
5、在'params'子数组内添加 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION。
6、可选：添加 'break_match_str' => ['2006', 'MySQL server has gone away'] 以增强错误匹配精度。
二、按运行环境差异化配置
该方法避免在FPM Web请求中因事务上下文被意外重连导致数据不一致，同时保障CLI长任务连接可靠性，适用于混合部署架构。
1、在全局配置中将 'break_reconnect' => false 作为默认值。
2、进入CLI命令类（如app/command/YourCommand.php）。
3、在execute()方法开头调用 config('database.connections.mysql.break_reconnect', true)。
4、或使用 Db::init(array_merge(config('database.connections.mysql'), ['break_reconnect' => true])) 重新初始化连接实例。
5、确认该配置变更仅作用于当前CLI进程生命周期，不影响Web请求链路。
三、手动封装带重试逻辑的查询操作
该方法绕过框架自动重连限制，对关键业务操作（如支付回调、库存扣减）提供可控的失败重试能力，支持自定义次数、间隔与错误类型过滤。
1、捕获异常时限定为 \think\db\exception\PDOException 类型。
2、使用for循环控制重试次数，建议上限设为 3次。
3、每次重试前插入 usleep(100000)（即100毫秒）防止雪崩。
4、若在事务中执行，每次重试前必须调用 Db::startTrans() 重新开启事务。
5、最后一次重试失败后，直接抛出原始异常，不再静默吞掉。
四、切换ThinkPHP-Queue运行模式
该方法从进程模型层面消除连接长期空闲问题，适用于队列任务执行时间较长或稳定性要求极高的场景，彻底规避连接超时风险。
1、停止当前work模式进程：php think queue:stop。
2、改用listen模式启动队列监听：php think queue:listen --queue=default。
3、确认系统已配置supervisor或systemd守护该listen进程，防止意外退出。
4、每个队列任务均以独立PHP子进程运行，数据库连接随进程创建与销毁，天然隔离连接状态。
5、验证日志中不再出现2006错误，且任务执行成功率显著提升。
