问题现象

在使用宝塔面板自带的MySQL服务时，无论是项目连接还是本地数据库客户端访问，都偶尔出现连接超时中断的情况，导致应用无法稳定运行。

根本原因分析

经过对MySQL配置文件的排查，发现问题出在以下两个关键参数上：

net_read_timeout = 30

这两个参数默认设置为30秒，正是造成连接频繁中断的核心所在。

mysqlx_read_timeout = 30

当MySQL服务器在30秒内未能完整接收客户端发送的数据包时，便会主动断开连接。这直接引发了应用程序中常见的：

SocketTimeoutException: Read timed out

此类异常报错。

解决方案：修改MySQL超时配置

方法一：通过宝塔面板图形化界面操作（推荐）

1. 登录宝塔面板
   打开浏览器，访问您的宝塔管理地址，并使用管理员账号完成登录。
2. 进入MySQL管理模块
   点击左侧导航栏中的“数据库”选项，找到当前运行的MySQL服务，点击其对应的“设置”按钮；或进入“软件商店”，搜索“MySQL”，然后选择“设置”。
3. 编辑配置文件
   在MySQL设置页面中，选择“配置修改”或直接点击“my.cnf”进行编辑。
   定位到如下配置区域：

[mysqld]

4. 调整关键参数
   查找并修改以下设置项：

[mysqld]
# 网络读取超时 - 从30秒改为300秒(5分钟)
net_read_timeout = 300

# 网络写入超时 - 保持或增大
net_write_timeout = 600

# X协议读取超时 - 从30秒改为300秒
mysqlx_read_timeout = 300

# X协议写入超时 - 可选优化
mysqlx_write_timeout = 300

# 连接超时 - 可选优化,从10秒改为30秒
connect_timeout = 30

5. 保存并重启服务
   点击“保存”按钮，返回MySQL管理界面，执行“重启”操作（可通过“服务”→“重启”）。
   等待服务重启完成，通常耗时10至30秒。
6. 验证配置是否生效
   重启成功后，在MySQL命令行或管理工具中执行以下SQL语句进行确认：

SHOW VARIABLES LIKE 'net_read_timeout';
SHOW VARIABLES LIKE 'net_write_timeout';
SHOW VARIABLES LIKE 'mysqlx_read_timeout';

预期输出结果应为：

net_read_timeout

net_write_timeout

mysqlx_read_timeout

方法二：通过SSH命令行方式修改（备用方案）

若图形界面操作受限，可采用SSH远程连接方式进行配置更改：

# 1. 使用SSH连接服务器
ssh root@your_server_ip

# 2. 编辑MySQL配置文件
vi /etc/my.cnf
# 或根据实际路径修改
vi /www/server/mysql/etc/my.cnf

# 3. 在 [mysqld] 段落下添加或更新以下内容
[mysqld]
net_read_timeout = 300
net_write_timeout = 600
mysqlx_read_timeout = 300

# 4. 保存退出（输入 :wq）
# 5. 重启MySQL服务
/etc/init.d/mysqld restart
# 或使用宝塔命令重启
bt restart mysqld

参数说明与优化建议值

net_read_timeout

net_write_timeout

mysqlx_read_timeout

mysqlx_write_timeout

connect_timeout

wait_timeout

interactive_timeout

为何建议设置为300秒？

• 与应用层配置匹配：多数Spring Boot等框架的数据库连接池默认超时时间为5分钟（即300秒），

  socketTimeout=300000

  ，保持数据库侧不低于此值可避免提前断连。
• 预留缓冲空间：设定为300秒大于实际需求，确保数据库不会先于应用触发超时机制。
• 避免资源浪费：数值不过大，防止长时间僵尸连接占用系统资源。

修改后的验证流程

1. 重启应用服务
   完成MySQL配置更新并重启数据库后，请同步重启您的Spring Boot应用：
   

   # 停止应用
   # 启动应用

2. 监控日志输出
   启动完成后，持续观察应用日志约30分钟：
• 正常表现：

  未再出现

  CommunicationsException

  和

  SocketTimeoutException

  连接池工作稳定，无异常中断。

• 仍存在问题：

  若继续报超时错误，则需进一步排查网络状况或其他中间件限制。

3. 压力测试验证（可选）
   可使用JMeter等工具模拟高并发场景，检验连接稳定性。

常见问题解答

Q1: 修改配置后MySQL无法启动怎么办？
A: 请检查配置语法是否正确，特别注意

=

Q2: 找不到MySQL配置文件的位置？
A: 宝塔环境下，配置文件通常位于以下路径之一：

/etc/my.cnf

/www/server/mysql/etc/my.cnf

/etc/mysql/my.cnf

Q3: 配置修改后仍然出现超时？
A: 请依次确认：

• MySQL服务已正确重启 ——

  systemctl status mysqld

• 新配置已加载生效 —— 执行

  SHOW VARIABLES LIKE 'net_read_timeout';

  查询验证
• 防火墙或安全组策略是否对3306端口设置了额外的连接超时规则

Q4: 修改配置会影响正在使用的连接吗？
A: 是的，重启MySQL会导致所有现有连接短暂中断。建议在业务低峰期操作，并提前通知相关人员。

Q5: 调整这些超时参数会影响数据库性能吗？
A: 不会。

net_read_timeout

其他可选优化建议

如果数据库访问依然不稳定，可考虑以下进阶调优措施：

• 增加最大连接数（适用于连接频繁达到上限的情况）：
  

  max_connections = 500

• 优化缓冲区大小，提升数据处理能力：
  

  max_allowed_packet = 64M
  innodb_buffer_pool_size = 2G  # 根据服务器内存调整

• 开启慢查询日志，帮助定位潜在性能瓶颈：
  

  slow_query_log = 1
  slow_query_log_file = /var/log/mysql/slow.log
  long_query_time = 2

总结

必须调整的核心参数为：

net_read_timeout = 300

mysqlx_read_timeout = 300

通过合理延长超时时间，能够有效解决因短暂网络延迟或大数据传输引发的连接中断问题，显著提升系统稳定性。

调整完这两个参数并重启MySQL服务后，连接超时的问题应当能够得到彻底解决。