XAMPP 的 MySQL 默认读取 C:\xampp\mysql\conf\my.ini,需在此文件 [mysqld] 段设置 wait_timeout 和 interactive_timeout,并彻底终止 mysqld.exe 进程后重启服务,再用 SELECT @@wait_timeout 验证生效。

XAMPP 的 MySQL 默认 wait_timeout 是 28800 秒(8 小时),但 Windows 下常因服务管理方式导致修改后不生效——不是改错,而是没改对位置或没重启对进程。
怎么找到 XAMPP 真正读取的配置文件
XAMPP 启动 MySQL 时并不一定读 C:\xampp\mysql\bin\my.ini 或 C:\xampp\mysql\my.ini,它优先加载 C:\xampp\mysql\conf\my.ini(注意是 conf 子目录)。很多用户改了根目录下的 my.ini 却无效,就是因为 MySQL 实际加载的是这个路径。
验证方法:在命令行执行:mysqld --help --verbose | findstr "Default options"
输出里会列出所有尝试加载的配置路径,逐个检查哪个文件里有 [mysqld] 段并包含 wait_timeout。
- 如果多个文件都定义了
wait_timeout,以最后一个被加载且生效的[mysqld]段为准 - Windows 下 XAMPP 控制面板点击 “Shell” 进入命令行后,
cd C:\xampp\mysql\bin再运行mysqld --print-defaults可看到最终合并后的启动参数 - 别依赖
SET GLOBAL wait_timeout = 600—— XAMPP 重启后丢失,且已有连接不会继承新值
改完配置必须彻底重启 MySQL 服务
XAMPP 控制面板点 “Stop” 再点 “Start” 不一定等于真正重启 mysqld 进程。常见问题:
- 任务管理器里还有残留的
mysqld.exe进程,导致新配置没加载 - 控制面板显示“Running”,但实际是旧进程在跑(可通过
netstat -ano | findstr :3306查 PID 对应进程确认) - 改完
my.ini后只重启 Apache,MySQL 没重启
稳妥做法:
先在控制面板 Stop MySQL → 打开任务管理器结束所有 mysqld.exe → 再 Start MySQL。
重启后立即验证:mysql -u root -e "SELECT @@wait_timeout, @@interactive_timeout;"
确保两个值一致且为你设的数值(如 600)。
为什么设了 600 秒还是报 “MySQL server has gone away”
根本原因不是 MySQL 没断开,而是你的 PHP 或应用没配合回收空闲连接。XAMPP 自带的 PHP 常用 mysql_connect()(已废弃)或 mysqli 长连接,但默认不校验连接有效性。
- PHP 脚本里用
mysqli::ping()或mysqli_ping($link)在查询前手动探活,否则拿了个已被 MySQL 断掉的连接直接崩 - 若用 PDO,需显式开启
PDO::ATTR_EMULATE_PREPARES => false和PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,并在 query 前加$pdo->getAttribute(PDO::ATTR_CONNECTION_STATUS)判断(不推荐,开销大) - 更合理的是:把 PHP-FPM 的
max_children和pm.max_requests设小些(如100),让 worker 进程定期重建连接,天然规避空闲超时
云环境或 Docker 下 XAMPP 不适用?别套用
XAMPP 是本地开发包,它的 my.ini 修改逻辑不适用于:
- 阿里云 RDS、腾讯云 CDB:不开放配置文件,只能走控制台「参数模板」修改,且
wait_timeout最小值可能被限制为 60 秒 - Docker 启动的 MySQL:需挂载自定义
my.cnf到/etc/mysql/conf.d/,而不是改容器内/opt/lampp/下的路径 - WSL2 中的 XAMPP:Windows 版 XAMPP 无法直接用于 WSL2,得用 Linux 原生 MySQL 包
本地调试没问题,但一旦部署到其他环境,光调 XAMPP 的 wait_timeout 是半步——连接池、应用层心跳、DNS 缓存这些环节一个没对齐,照样报错。


















