“max_user_connections”报错是MySQL用户级连接数超限所致，需确认当前用户活跃连接是否达上限（如云虚拟主机默认80），并检查ThinkPHP是否误启持久连接、未释放连接或未配置break_reconnect与PDO::ATTR_TIMEOUT。
“max_user_connections”报错不是 ThinkPHP 配置错了，而是 MySQL 拒绝了新连接——当前用户已达到数据库服务端允许的最高并发连接数（通常是 80，云虚拟主机常见），必须从连接生命周期和 MySQL 用户级限制两头入手。
查清楚是哪个用户被限死了
ThinkPHP 默认用配置文件里的 username 连接数据库，而 max_user_connections 是按 MySQL 用户粒度限制的。先确认是不是这个用户真撞上限了：
- 登录 MySQL 执行：
SHOW VARIABLES LIKE 'max_user_connections';—— 看全局默认值（0 表示不限） - 再查具体用户：
SELECT User, Host, max_user_connections FROM mysql.user WHERE User = 'your_db_user'; - 观察当前该用户的活跃连接：
SHOW PROCESSLIST;，过滤出User列为你的用户名的行，数一数有多少条Sleep或Query状态
如果结果里 max_user_connections 是 80，且 PROCESSLIST 中同用户连接数 ≥ 80，就坐实了是它卡住的。
ThinkPHP 层必须关掉持久连接
TP5/6 默认不启用持久连接，但一旦在数据库配置中误加 PDO::ATTR_PERSISTENT => true，或框架扩展、中间件、命令行脚本里手动启用了，就会导致连接长期滞留不释放——尤其在 PHP-FPM 子进程复用场景下，一个连接能“挂尸”几分钟甚至更久。
立即学习“PHP免费学习笔记（深入）”；
- 检查
config/database.php中的params数组，确保不含PDO::ATTR_PERSISTENT => true - CLI 场景（如定时任务）最容易漏关：每次执行都应显式断开，例如在命令结束前加
$pdo = null;或Db::close(); - 避免在循环中反复调用
Db::connect()；改用单例复用：$db = Db::connect('default');，并在作用域结束前释放引用
MySQL 侧不能只调 max_connections，得动 max_user_connections
云虚拟主机（如阿里云、腾讯云共享型）通常不允许修改全局 max_connections，但允许对单个用户调整 max_user_connections——前提是账号有 GRANT OPTION 权限。本地或 ECS/RDS 环境可直接操作：
- 临时生效（重启失效）：
SET GLOBAL max_user_connections = 200;（影响所有用户） - 仅限当前用户：
ALTER USER 'your_db_user'@'%' WITH MAX_USER_CONNECTIONS 200; - 永久生效需写入 MySQL 配置文件（
my.cnf的[mysqld]段）：max_user_connections = 200，然后重启服务 - 注意：设太高会吃内存，每个连接约占用 256KB～1MB；若用户实际并发请求远低于 50，设成 100 就足够
别忽略 wait_timeout 和连接泄漏的叠加效应
很多“max_user_connections 超限”其实是假象——真实原因是连接没释放 + wait_timeout 太长，导致大量 Sleep 连接堆积，把名额占满。比如云 RDS 常把 wait_timeout 设为 300 秒，而 ThinkPHP 某段代码异常后跳过了 Db::close()，连接就挂着不动。
- 查当前值：
SHOW VARIABLES LIKE 'wait_timeout';，建议调低到60～120 - ThinkPHP 配置中加
'break_reconnect' => true，应对 MySQL 主动断连后的重连逻辑 - 务必配
'params' => [PDO::ATTR_TIMEOUT => 5]，否则 PDO 新建连接时可能卡在系统 TCP 超时（Linux 默认 75 秒），进一步拖慢释放节奏 - 压测时定期跑
SHOW PROCESSLIST;抓快照，对比不同时间点的 Sleep 连接增长趋势，比单纯看总数更有诊断价值
真正难排查的是连接泄漏：某次异常中断让 Db::close() 没执行，或者事务闭包里忘了释放资源。这类问题不会立刻报错，但几天后突然崩——所以开发期就要养成查 PROCESSLIST 的习惯。
