在使用XAMPP搭建本地开发环境的过程中，MySQL默认的最大连接数通常设置为151，当同时有多个服务请求连接数据库，或者并发访问量超过这个阈值时，就会触发Too many connections报错，导致数据库无法正常响应请求。我们可以通过修改MySQL的配置文件来调整最大连接数，解决这个常见问题。
问题产生的原因
MySQL的最大连接数参数max_connections决定了同时可以建立的客户端连接上限，XAMPP默认安装的MySQL版本该参数值较低，当以下场景出现时就容易触发报错：
- 本地同时运行多个Web项目，每个项目都保持数据库连接
- 执行批量数据导入、多并发接口测试等操作
- 程序中未正确关闭数据库连接，导致连接泄漏累积
修改XAMPP中MySQL最大连接数的步骤
1. 找到MySQL配置文件
XAMPP的MySQL配置文件my.ini通常存放在XAMPP安装目录下的mysql/bin文件夹中，比如默认安装路径为C:xampp的话，配置文件路径就是C:xamppmysqlbinmy.ini。如果找不到该文件，可以打开XAMPP控制面板，点击MySQL对应的Config按钮，在下拉菜单中选择my.ini即可直接打开。
2. 修改配置文件参数
打开my.ini文件后，找到[mysqld]配置段，在该段中添加或修改max_connections参数，设置你需要的最大连接数数值，建议根据本地开发需求设置，一般设置为500到1000即可满足大部分场景。示例配置如下：
[mysqld] # 设置MySQL最大连接数为500 max_connections=500 # 可选：设置每个连接的最大错误数，避免恶意连接 max_connect_errors=100 # 可选：设置连接超时时间，单位秒 wait_timeout=300
3. 重启MySQL服务
修改完配置文件后，需要重启XAMPP中的MySQL服务才能让配置生效。打开XAMPP控制面板，先点击MySQL对应的Stop按钮停止服务，等待服务停止后再点击Start按钮启动服务即可。
验证配置是否生效
重启服务后，我们可以登录MySQL执行查询语句，确认max_connections参数已经被正确修改。登录MySQL的方式可以在XAMPP控制面板点击MySQL对应的Shell按钮，进入命令行后执行以下命令：
-- 登录MySQL，默认root用户无密码 mysql -u root -p -- 输入密码后执行以下查询语句 SHOW VARIABLES LIKE 'max_connections';
如果返回的结果中Value列显示为你设置的数值，比如500，就说明配置已经生效。
注意事项
- 不要将max_connections设置得过高，过高的连接数会占用更多内存资源，本地开发环境一般不需要超过2000
- 如果修改后重启MySQL失败，可能是配置文件语法错误，检查是否有多余的空格或者拼写错误
- 如果是程序连接泄漏导致的问题，除了调整连接数，还需要检查代码中是否正确关闭了数据库连接，避免连接长期占用
调整最大连接数只是临时解决高并发场景下的连接不足问题，如果是代码层面的连接未释放问题，还需要同步优化程序逻辑，才能从根源上避免Too many connections报错。
XAMPPMySQL最大连接数Too_many_connections修改时间：2026-07-16 16:09:29