MySQL server has gone away是MySQL数据库中非常常见的错误提示，出现该错误时通常表示当前客户端与MySQL服务器的连接已经断开，无法继续执行后续的数据库操作。该错误的触发原因比较多，最常见的包括连接长时间闲置超过了服务器的超时配置、单次传输的数据包大小超过了服务器限制等。
方法一：调整MySQL服务器的超时配置参数
MySQL服务器有两个核心的超时参数控制连接的存活时间，分别是wait_timeout和interactive_timeout，如果这两个参数的值设置过小，连接闲置时间超过该值就会被服务器主动关闭，从而触发MySQL server has gone away错误。
查看当前超时参数配置
可以先登录MySQL命令行，执行以下语句查看当前的参数值：
-- 查看非交互式连接的超时时间，单位秒 SHOW VARIABLES LIKE 'wait_timeout'; -- 查看交互式连接的超时时间，单位秒 SHOW VARIABLES LIKE 'interactive_timeout';
修改超时参数
如果当前参数值过小，比如默认值可能是28800秒（8小时），可以根据业务需求调大该值，有两种修改方式：
临时修改（重启MySQL后失效）
直接在MySQL命令行执行以下语句修改：
-- 设置非交互式连接超时时间为24小时 SET GLOBAL wait_timeout = 86400; -- 设置交互式连接超时时间为24小时 SET GLOBAL interactive_timeout = 86400;
永久修改（重启MySQL后生效）
需要修改MySQL的配置文件my.cnf（Linux系统）或者my.ini（Windows系统），在[mysqld]节点下添加或修改以下配置：
[mysqld] wait_timeout=86400 interactive_timeout=86400
修改完成后重启MySQL服务即可生效。
方法二：优化应用程序的数据库连接管理逻辑
除了调整服务器参数，还可以在应用程序层面优化连接管理，避免连接长时间闲置或者重复使用已经断开的连接。
使用连接池并配置连接校验
大部分开发语言的数据库连接池都支持配置连接校验逻辑，在获取连接时先检查连接是否有效，无效则重新创建连接。以Java的Druid连接池为例，配置方式如下：
// Druid连接池配置示例
DruidDataSource dataSource = new DruidDataSource();
// 设置数据库基本连接信息
dataSource.setUrl("jdbc:mysql://127.0.0.1:3306/test_db?useUnicode=true&characterEncoding=utf8");
dataSource.setUsername("root");
dataSource.setPassword("123456");
// 配置连接校验SQL，获取连接时执行该SQL检查连接是否有效
dataSource.setValidationQuery("SELECT 1");
// 设置从连接池获取连接时校验有效性
dataSource.setTestOnBorrow(true);
// 设置连接池最小空闲连接数
dataSource.setMinIdle(5);
// 设置连接池最大活跃连接数
dataSource.setMaxActive(20);
避免长连接闲置
如果应用程序中存在长时间不使用数据库的场景，可以在闲置阶段主动关闭连接，或者设置定时任务定期执行简单的查询语句保持连接活跃，比如每隔一段时间执行SELECT 1语句。
两种方法的适用场景对比
以下是两种方法的适用场景对比，方便开发者选择：
| 解决方法 | 适用场景 | 优点 | 缺点 |
|---|---|---|---|
| 调整MySQL超时参数 | 业务中存在合理的长连接闲置场景，不需要频繁调整应用代码 | 实现简单，不需要修改应用代码 | 过长的超时时间可能会占用更多服务器资源 |
| 优化应用连接管理 | 应用需要灵活控制连接生命周期，或者服务器资源有限不能调大超时时间 | 资源利用率更高，连接管理更可控 | 需要修改应用代码，实现成本稍高 |
在实际使用中，也可以将两种方法结合使用，既适当调整服务器的超时参数，也在应用层面做好连接校验和管理，最大程度避免MySQL server has gone away错误的出现。
MySQLMySQL_server_has_gone_away数据库连接超时wait_timeoutinteractive_timeout修改时间：2026-06-12 21:21:28