MySQL常见报错分析及解决方案总结(11)---net_read_timeout 或 net_write_timeout

原创已于 2025-09-24 15:02:22 修改 · 2k 阅读

12 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

报错问题

于 2025-09-04 08:48:03 首次发布

该文章已生成可运行项目，

关于超时报错，一共有五种超时参数，详见：MySQL常见报错分析及解决方案总结(7)---超时参数connect_timeout、interactive_timeout/wait_timeout、lock_wait_timeout、net等-CSDN博客

以下是当前报错的排查方法和解决方案：

在 Windows 系统上，Java 程序连接 MySQL 时遇到 net_read_timeout 或 net_write_timeout 错误，通常与网络数据传输超时相关，表现为读写数据过程中连接中断。以下是具体说明：

一、报错效果

当数据读写超时发生时，Java 程序会抛出类似以下的错误信息：

com.mysql.cj.jdbc.exceptions.CommunicationsException: Communications link failure

The last packet successfully received from the server was 2,000 milliseconds ago. The last packet sent successfully to the server was 2,000 milliseconds ago.

或更明确的提示：

java.sql.SQLException: Read timed out

java.sql.SQLException: Write timed out

核心特征：

SQL 执行过程中（如读取大量数据、写入大字段）突然中断，而非连接初期。
错误与 “read timeout” 或 “write timeout” 直接相关，通常伴随 “Communications link failure”。

二、参数含义与引起报错的原因

net_read_timeout：MySQL 服务器等待客户端发送数据的超时时间（默认 30 秒）。若客户端（Java 程序）发送数据过慢，超过此时间，服务器会关闭连接。
net_write_timeout：MySQL 服务器向客户端写入数据时的超时时间（默认 60 秒）。若客户端接收数据过慢（如网络拥堵），服务器会关闭连接。

常见触发原因：

网络传输缓慢或不稳定
- 客户端与 MySQL 服务器之间网络延迟高、带宽低，导致数据读写耗时超过阈值。
- Windows 系统防火墙或安全软件对数据包进行扫描 / 拦截，拖慢传输速度。
处理大数据量操作
- 执行返回大量结果集的 SELECT 语句（如无分页的全表查询），服务器发送数据耗时过长。
- 写入大字段（如 BLOB、TEXT 类型的文件、长文本），客户端接收或服务器发送超时。
程序逻辑导致的读写延迟
- Java 程序在读取 ResultSet 时，处理每条记录耗时过长（如复杂计算、同步操作），导致服务器等待超时。
- 事务中包含大量分步操作，中间逻辑阻塞了数据传输。
参数设置过小
- 手动将 net_read_timeout 或 net_write_timeout 设为过小的值（如 5 秒），正常操作也可能超时。

三、解决办法

1. 优化网络环境

检查网络稳定性：通过 ping 服务器IP -t（Windows 命令）测试网络延迟，若丢包或延迟过高，需排查网络设备（路由器、交换机）或更换网络。
关闭不必要的网络安全软件：暂时禁用 Windows 防火墙或第三方杀毒软件，测试是否因拦截导致超时（若解决，需添加 MySQL 进程和端口的例外规则）。

2. 调整 MySQL 超时参数

根据业务场景（尤其是大数据操作）延长超时时间：

临时修改（当前会话有效）：
在 MySQL 客户端执行（单位：秒）：
```
set global net_read_timeout = 120;  -- 延长至120秒
set global net_write_timeout = 180; -- 延长至180秒
```
注意：已建立的连接需重新连接才生效。
永久修改（需重启 MySQL）：
编辑 my.ini 配置文件（Windows 路径通常为 C:\ProgramData\MySQL\MySQL Server x.x\my.ini），在 [mysqld] 下添加：
```
[mysqld]
net_read_timeout=120
net_write_timeout=180
```
重启 MySQL 服务：在 “服务” 中找到 “MySQL”，右键 “重启”。

3. 优化 Java 程序与 SQL 操作

避免大数据量一次性传输：
- 对查询结果分页：使用 LIMIT 分批获取数据（如 SELECT * FROM table LIMIT 0, 1000）。
- 大字段拆分：将 BLOB/TEXT 数据拆分为小片段传输，或通过文件系统存储而非数据库。

加快数据处理速度：

避免在 ResultSet 遍历中执行耗时操作（如网络请求、复杂计算），可先批量读取数据到内存再处理。

// 优化前：边读边处理（可能超时）
while (rs.next()) {
    processData(rs.getString(1)); // 耗时操作
}

// 优化后：先批量读取，再处理
List<String> dataList = new ArrayList<>();
while (rs.next()) {
    dataList.add(rs.getString(1)); // 快速读取
}
// 单独处理数据（不占用数据库连接）
for (String data : dataList) {
    processData(data);
}

设置 JDBC 连接超时参数：
在连接 URL 中添加客户端读写超时参数（补充 MySQL 服务器端设置）：
```
String url = "jdbc:mysql://localhost:3306/dbname?useSSL=false"
    + "&connectTimeout=30000"  // 连接超时（30秒）
    + "&socketTimeout=180000"; // 套接字读写超时（180秒）
```
socketTimeout 会覆盖客户端的读写等待时间，需大于服务器端的 net_read_timeout/net_write_timeout。