如何解决“MySQLhasgoneaway”错误，使用FacileIt/DoctrineMySQLComeBack让数据库连接自动恢复-小浪学习网

最近在开发一个长期运行的php应用时，我遇到了一个让人头疼的问题：时不时地，我的应用程序会抛出“mysql has gone away”的错误。这简直是噩梦！它不仅导致用户操作失败，还会让后台的批处理任务中断。我尝试过各种方法，比如增加PHP的执行时间限制、调整MySQL服务器的wait_timeout参数，甚至在代码中手动添加try-catch块来捕获异常并尝试重连，但这些方案要么不彻底，要么大大增加了代码的复杂度和维护成本。

这个问题通常发生在php应用与mysql 数据库建立连接后，如果该连接长时间处于空闲状态，mysql服务器可能会因为超时而关闭它。当应用程序再次尝试使用这个已关闭的连接执行查询时，就会遇到“mysql has gone away”的错误。此外，网络波动、数据库服务器重启等突发情况也可能导致连接断开。对于一个需要高稳定性的应用来说，这种不确定性是无法接受的。

救星登场：facile-it/doctrine-mysql-come-back

幸好，PHP社区总能找到优雅的解决方案。在一番搜索和尝试后，我发现了facile-it/doctrine-mysql-come-back这个composer包。它完美地解决了我的痛点，提供了一个Doctrine DBAL驱动的包装器，能够在数据库连接断开时自动尝试重新连接，而无需我手动编写复杂的重试逻辑。

这个库最棒的地方在于它的智能性：它只在“安全”的情况下尝试重连，例如在读取操作时，或者当前没有进行中的事务。这意味着它会避免在写入操作或事务中途进行不安全的重连，从而最大限度地保障数据的一致性和完整性。

如何使用 Composer 引入并配置它？

使用facile-it/doctrine-mysql-come-back非常简单，只需通过Composer安装，并在Doctrine配置中稍作修改即可。

1. 安装

首先，根据你使用的Doctrine DBAL版本，通过Composer安装相应的包：

# 如果你使用 DBAL 4.0+ composer require facile-it/doctrine-mysql-come-back ^3.0  # 如果你使用 DBAL 3.6+ composer require facile-it/doctrine-mysql-come-back ^2.0  # 如果你使用 DBAL ^2.3 composer require facile-it/doctrine-mysql-come-back ^1.0

2. 配置

安装完成后，你需要将Doctrine连接的wrapperClass参数设置为FacileDoctrineMySQLComeBackDoctrineDBALConnection。同时，你还可以通过x_reconnect_attempts选项配置最大重连尝试次数。

以下是一个在原生DBAL中配置的示例：

use DoctrineDBALConfiguration; use DoctrineDBALDriverManager;  $config = new Configuration();  $connectionParams = [     'dbname' => 'your_database',     'user' => 'your_user',     'password' => 'your_password',     'host' => 'localhost',     // [facile-it/doctrine-mysql-come-back] 设置     'wrapperClass' => 'FacileDoctrineMySQLComeBackDoctrineDBALConnection', // 关键设置     'driverOptions' => [         'x_reconnect_attempts' => 3 // 最多尝试重连3次     ], ];  $conn = DriverManager::getConnection($connectionParams, $config);  // 现在，当连接断开时，它会自动尝试重连 $result = $conn->fetchAssociative('SELECT 1');

如果你在symfony项目中，可以在doctrine.yaml中进行配置：

doctrine:     dbal:         connections:             default:                 url: '%env(resolve:DATABASE_URL)%'                 wrapper_class: 'FacileDoctrineMySQLComeBackDoctrineDBALConnection'                 options:                     x_reconnect_attempts: 3

如果你使用的是主从复制（Primary/Replica）配置，也可以使用特定的包装类：FacileDoctrineMySQLComeBackDoctrineDBALConnectionsPrimaryReadReplicaConnection。