ThinkPHP-Queue与MySQL断线重连的终极指南：从问题定位到配置优化

ThinkPHP-Queue与MySQL断线重连的终极指南：从问题定位到配置优化

1. 问题现象与根源分析

当你在生产环境中使用ThinkPHP-Queue处理异步任务时，是否遇到过这样的场景：队列任务运行一段时间后突然报错"MySQL server has gone away"，导致业务中断？这个问题在长时间运行的CLI模式下尤为常见。

核心问题根源在于MySQL服务器的连接超时机制。MySQL默认会在8小时无活动后断开空闲连接（可通过wait_timeout参数配置）。而在ThinkPHP-Queue的work模式下，进程会保持MySQL连接不释放，当连接空闲时间超过MySQL服务器的超时设置时，服务器端会主动断开连接，但客户端（队列进程）并不知情，继续使用这个已断开的连接就会触发"gone away"错误。

典型错误日志如下：

SQLSTATE[HY000]: General error: 2006 MySQL server has gone away

2. 解决方案全景图

针对这个问题，我们有三种不同层级的解决方案，可根据业务场景灵活选择：

2.1 基础方案：启用断线重连

ThinkPHP内置了数据库断线重连机制，只需简单配置即可启用：

// config/database.php
'connections' => [
    'mysql' => [
        'break_reconnect' => true,    // 开启断线重连
        'break_match_str' => ['2006'], // 匹配gone away错误码
        // 其他配置...
    ]
]

这个方案的优势是配置简单，但有两个局限：

1. 重连发生时当前查询会失败，需要业务代码处理异常
2. 无法预防连接断开，只能在断开后补救

2.2 进阶方案：调整运行模式

ThinkPHP-Queue支持两种运行模式：

模式	特点	适用场景
work	长驻内存，单进程处理多个任务	任务轻量，执行时间短
listen	每次任务启动新进程	任务耗时，需要隔离环境

切换到listen模式可以彻底避免连接保持问题，因为每个任务都是独立进程，会新建数据库连接：

php think queue:listen --queue=your_queue_name

2.3 终极方案：全链路优化

对于高要求的线上环境，建议采