Laravel应用偶发MySQL连接拒绝（SQLSTATE[HY000] [2002]）问题

云原生阿岚

2026-7-30

Laravel 偶尔出现 SQLSTATE[HY000] [2002] Connection refused 问题排查方案

可能原因及解决办法

数据库连接池配置不合理
Laravel默认配置可能未启用连接池或参数设置不当。修改config/database.php中的MySQL连接配置，添加连接池参数：
```
'mysql' => [
    // 保留原有host、database、username等配置
    'pool' => [
        'min' => 5,
        'max' => 30,
        'idle' => 60,
    ],
]
```
确保Laravel版本（8.x及以上）支持原生连接池功能，或依赖illuminate/database的连接池实现。
MySQL连接数限制触发
当短时间请求量过高，超出MySQL最大连接数限制时会出现连接拒绝。通过MySQL命令查看当前配置：
```
SHOW VARIABLES LIKE 'max_connections';
SHOW VARIABLES LIKE 'wait_timeout';
```
若max_connections过低，可在my.cnf（或my.ini）中调整：
```
max_connections = 200
wait_timeout = 600
```
调整后重启MySQL服务。
TCP连接复用问题
Linux服务器上，TCP连接关闭后可能处于TIME_WAIT状态，导致无法快速建立新连接。临时调整系统TCP参数：
```
# 允许复用TIME_WAIT状态的连接
echo 1 > /proc/sys/net/ipv4/tcp_tw_reuse
# 缩短TIME_WAIT超时时间
echo 30 > /proc/sys/net/ipv4/tcp_fin_timeout
```
若要永久生效，将上述配置添加到/etc/sysctl.conf，执行sysctl -p使配置生效。
添加数据库连接重试逻辑
在数据库操作处增加重试机制，避免单次连接失败直接抛出错误。使用Laravel的retry辅助函数：
```
$result = retry(3, function () {
    return DB::table('target_table')->where('condition', true)->get();
}, 100);
```
该代码会尝试3次连接，每次间隔100毫秒，直到成功或重试耗尽。
服务器资源瓶颈排查
检查服务器CPU、内存、磁盘IO使用率，资源耗尽时MySQL可能无法响应新连接。使用top、htop、iostat等工具监控状态，必要时升级服务器配置或优化应用的数据库查询（比如添加索引、减少单次查询数据量）。