TP5.1报“Max user connections reached”是因数据库账号的MAX_USER_CONNECTIONS限制被触发，需用ALTER USER设置该用户连接上限，并确保应用连接池大小≤该值，禁用持久连接，长生命周期环境须手动释放PDO。
TP5.1 报错 “Max user connections reached”，说明 MySQL 拒绝了新连接，不是因为实例总连接数满了（Too many connections），而是当前应用使用的数据库账号**已达到其被允许的最大并发连接数限制**。这个限制叫 MAX_USER_CONNECTIONS，必须显式为该用户设置，且只对新建连接校验。
确认问题根源：是用户级限制触发的
先排除混淆：
- 报错里明确含 “user connections”（不是 “Too many connections”），基本可锁定是
MAX_USER_CONNECTIONS生效； - 执行
SELECT User, Host, max_user_connections FROM mysql.user WHERE User = 'your_app_user';，若返回值是具体数字（如 5、10），而非0或NULL，就是它在起作用； - 查实时活跃连接：
SELECT user, COUNT(*) FROM performance_schema.threads WHERE TYPE = 'FOREGROUND' AND user = 'your_app_user';，结果应接近你设的上限值。
正确设置单用户连接上限（MySQL 5.7.6+）
必须用 ALTER USER，其他方式无效：
- 给已有用户设限（最常用）：
ALTER USER 'app_user'@'%' WITH MAX_USER_CONNECTIONS 10;
注意：'app_user'@'%'中的Host必须和SHOW GRANTS FOR 'app_user'@'%'输出完全一致； -
'app_user'@'localhost'和'app_user'@'127.0.0.1'是两个独立账号，需分别设置； - 设为
0表示不限制（退回到全局max_connections约束），不是禁止登录； - 无需
FLUSH PRIVILEGES，立即生效。
TP5.1 应用层必须同步适配
光设数据库限制不够，应用连接池若超出该值，启动或压测时必失败：
- 检查配置文件（如
database.php）中 PDO 连接参数：
确保'params' => [PDO::ATTR_PERSISTENT => false]（禁用持久连接）； - 若使用连接池中间件（如 Swoole 长连接、或自建连接池），其最大连接数（如
max_pool_size）必须 ≤ 数据库账号的MAX_USER_CONNECTIONS值； - 确认代码中没有漏掉
->close()或未释放 PDO 实例（PHP-FPM 模式下脚本结束会自动释放，但长生命周期环境如 Swoole 必须手动unset($pdo)）。
验证是否真正生效
别只看 SHOW PROCESSLIST —— 它显示的是已建立连接，而限制只在校验新建连接时触发：
- 开多个终端，并行执行：
mysql -u app_user -p -e "SELECT 1;"
第N+1次（N是你设的上限）应直接报错：ERROR 1226 (42000): User 'app_user' has exceeded the 'max_user_connections' resource； - 检查
mysql.user表字段是否已更新，这是唯一权威依据。
