Swoole项目中PDO连接MySQL超时问题分析与解决方案

问题现象分析

在Swoole协程环境下使用PDO连接MySQL数据库时，当查询结果集较大(如超过3万条记录)时，经常会出现"MySQL server has gone away"的错误。这种情况通常发生在以下场景：

1. 使用协程并发处理多个数据库查询
2. 每个协程都创建了独立的PDO连接
3. 执行大数据量查询并使用fetchAll()获取全部结果

根本原因剖析

这个问题主要由以下几个因素共同导致：

1. MySQL服务器超时设置：MySQL默认会关闭长时间空闲的连接，而大数据量查询和fetch操作耗时较长

2. PDO连接管理：在传统PHP-FPM模式下，每个请求结束后连接会自动释放，但在Swoole长生命周期进程中，连接会持续保持

3. 协程阻塞问题：虽然Swoole协程是异步非阻塞的，但像fetchAll()这样的操作会同步阻塞当前协程，导致连接长时间占用

4. 网络因素：大数据量传输需要更长时间，可能触发TCP层的超时机制

解决方案

1. 优化MySQL服务器配置

调整MySQL服务器的以下参数可以缓解问题：

• 增大wait_timeout参数值(默认8小时)
• 增大max_allowed_packet参数值(默认4MB)
• 调整interactive_timeout参数

2. 实现连接断线重连机制

在Swoole协程环境中，必须实现健壮的断线重连机制：

function queryWithRetry($pdo, $sql, $retry = 3) {
    for ($i = 0; $i < $retry; $i++) {
        try {
            $stmt = $pdo->query($sql);
            return $stmt->fetchAll();
        } catch (PDOException $e) {
            if ($e->getCode() == 'HY000' && strpos($e->getMessage(), 'server has gone away') !== false) {
                // 重新建立连接
                $pdo = new PDO($dsn, $user, $password);
                continue;
            }
            throw $e;
        }
    }
    throw new Exception("Query failed after {$retry} retries");
}

3. 使用分页查询替代大数据量查询

对于可能返回大量数据的查询，建议使用分页机制：

$pageSize = 1000;
$page = 1;

do {
    $offset = ($page - 1) * $pageSize;
    $sql = "SELECT * FROM large_table LIMIT {$offset}, {$pageSize}";
    $results = $pdo->query($sql)->fetchAll();
    
    // 处理当前页数据
    processResults($results);
    
    $page++;
} while (!empty($results));

4. 使用连接池管理

在Swoole中，推荐使用数据库连接池来管理连接：

1. 创建连接池
2. 从池中获取连接
3. 使用完毕后归还连接
4. 连接池自动处理失效连接

最佳实践建议

1. 避免在协程中使用fetchAll：对于大数据集，考虑使用fetch逐行处理

2. 设置合理的超时时间：为PDO连接设置适当的超时参数

3. 监控连接状态：定期检查连接活性，及时回收失效连接

4. 错误处理：对所有数据库操作添加适当的异常处理

5. 资源限制：对单次查询的数据量设置上限，防止单个查询耗尽资源

通过以上措施，可以显著提高Swoole项目中PDO连接MySQL的稳定性和可靠性，有效解决"MySQL server has gone away"等连接超时问题。