MySQL连接中断：解决"Connection refused"和"MySQL server has gone away"错误

2024-11-13 06:39:34

MySQL 连接中断：测试执行中的“Connection refused” 和 “MySQL server has gone away”

在 GitLab CI 等持续集成环境中运行测试时，偶尔会遇到 “Connection refused” 或 “MySQL server has gone away” 的错误，这通常表示 MySQL 连接出现问题。这篇文章将分析这些错误的常见原因，并提供相应的解决方案。

问题根源

连接被拒绝（"Connection refused"）通常发生在客户端尝试连接到 MySQL 服务器失败时。这表明服务器没有监听指定的端口，或者网络连接存在问题。服务器端防火墙配置或客户端网络配置错误也可能导致此问题。

而 “MySQL server has gone away” 错误则表明已建立的连接被服务器意外关闭。导致这个问题的原因有很多，包括：

服务器超时: MySQL 服务器在一段时间内没有活动后会自动关闭连接，尤其是在 wait_timeout 设置过短的情况下。
网络问题: 网络不稳定，例如网络波动或连接中断，会导致服务器关闭连接。
资源限制: 服务器资源（例如内存）不足，导致 MySQL 服务重启或崩溃。
大事务: 执行时间过长的大事务可能会导致服务器关闭连接。
max_allowed_packet 过小: 如果客户端发送的数据包大于服务器允许的最大值 max_allowed_packet，服务器将关闭连接。

解决之道

1. 验证 MySQL 服务器状态

首先，确认 MySQL 服务器正在运行并监听正确的端口。可以使用 telnet 或 nc 命令检查服务器的连接性。例如：

telnet mysql-host 3306
# 或
nc -zv mysql-host 3306

如果连接成功，telnet 会显示一个空屏幕；nc 会显示成功连接的信息。否则，需要检查服务器状态和端口配置。

2. 调整服务器超时设置

增加 MySQL 服务器的 wait_timeout 和 interactive_timeout 的值，可以延长服务器保持连接的时间。修改 /etc/mysql/my.cnf (或其他 MySQL 配置文件) 中的以下配置：

wait_timeout = 28800  # 8小时，单位为秒
interactive_timeout = 28800 # 8小时，单位为秒

修改后，重启 MySQL 服务使配置生效：

sudo systemctl restart mysql

合理的超时设置可以避免由于长时间不活动而导致的连接中断，但在设置较大的超时值时需要注意安全性，防止连接被恶意利用。

3. 优化网络连接

不稳定的网络连接是导致 “MySQL server has gone away” 的另一个常见原因。可以通过以下方法优化网络连接:

检查网络连接: 使用 ping 命令测试网络连通性，并检查网络延迟。
使用更稳定的网络环境: 如果可能，使用更稳定的网络连接。
优化网络配置: 检查客户端和服务器的网络配置，例如 DNS 解析和防火墙规则。

4. 调整服务器资源限制

确保 MySQL 服务器拥有足够的资源（内存、CPU、磁盘空间）来处理请求。监控服务器资源使用情况，并根据需要调整资源限制。例如，在 Kubernetes 环境下，可以修改 Deployment 配置文件：

spec:
  containers:
  - name: mysql
    resources:
      limits:
        cpu: 2
        memory: 4Gi
      requests:
        cpu: 1
        memory: 2Gi

这将增加分配给 MySQL 容器的 CPU 和内存资源。

5. 处理大事务

避免长时间运行的事务。将大事务拆分成多个小事务，可以减少服务器负载并降低连接中断的风险。并且，确保在代码中正确地提交或回滚事务，例如：

import mysql.connector

try:
    mydb = mysql.connector.connect(...)
    cursor = mydb.cursor()
    cursor.execute("START TRANSACTION")
    # 执行一系列SQL操作
    mydb.commit()
except Exception as e:
    mydb.rollback()
    print(f"事务回滚：{e}")
finally:
    if mydb.is_connected():
        cursor.close()
        mydb.close()