需先确认mysql中具体用户是否达到max_user_connections上限,再检查thinkphp是否误启持久连接或未释放连接,最后调整该用户的max_user_connections值并优化wait_timeout。

查清楚是哪个用户被限死了
“max_user_connections”是MySQL按账号粒度设的硬限制,和全局max_connections无关。ThinkPHP报错时连不上,大概率不是框架配错了,而是你配置文件里写的username在MySQL里被单独卡了上限——比如云主机默认给每个用户只放80个连接。
先登录MySQL(用root或有权限的账号),执行:SELECT User, Host, max_user_connections FROM mysql.user WHERE User = 'your_db_user';
如果返回值是80或更小数字,再跑:SHOW PROCESSLIST;
过滤出User列等于你的应用账号的行,数一数有多少条。≥80就坐实了是它堵死的。
ThinkPHP层必须关掉持久连接
TP5/6默认不启持久连接,但一旦你在数据库配置的params里加了PDO::ATTR_PERSISTENT => true,或者命令行脚本、中间件里手动调了Db::connect()又没显式Db::close(),连接就会挂在PHP-FPM子进程里不释放。尤其在高并发下,一个“挂尸”连接能占几分钟。
- 检查配置文件,删掉所有
PDO::ATTR_PERSISTENT相关设置 - 避免在循环里反复调
Db::connect();改用单例:$db = Db::connect('default');,并在作用域结束前让变量自然销毁 - 确认没在
__destruct()或异常分支里漏掉Db::close()
MySQL侧只能动max_user_connections
云虚拟主机通常不允许改max_connections,但允许对单个用户调max_user_connections——前提是你的账号有GRANT OPTION权限。
临时生效(重启不失效):ALTER USER 'your_db_user'@'%' WITH MAX_USER_CONNECTIONS 200;
永久生效要写进my.cnf的[mysqld]段:max_user_connections = 200
然后重启MySQL服务。
注意:max_user_connections设太高会吃内存,每个连接约256KB~1MB;如果实际并发远低于50,设成100就够用。别只盯着这个值,还得看wait_timeout——如果它设成28800(8小时),大量Sleep连接堆着不退,照样把限额占满。
别忽略wait_timeout和连接泄漏的叠加效应
很多“max_user_connections超限”其实是假象:应用没close() + wait_timeout太长 → 大量Sleep连接堆积 → 看似限额满了,实则是连接没释放。
查当前空闲连接时长:SELECT ID, USER, HOST, TIME, STATE FROM INFORMATION_SCHEMA.PROCESSLIST WHERE USER = 'your_db_user' AND COMMAND = 'Sleep' ORDER BY TIME DESC LIMIT 10;
如果TIME普遍>300秒,说明wait_timeout可能设得过大(默认28800秒)。可临时调低:SET SESSION wait_timeout = 60;
再配合应用层修复连接释放逻辑,才能根治。
真正难处理的,是那些既没显式关闭、又没触发wait_timeout自动回收的连接——它们往往卡在事务未提交、锁等待或网络中断状态,得靠KILL手动清理,但得先定位ID。











