PHP8应用报“too many connections”或“MySQL server has gone away”，本质是跨平台连接池语义错位导致连接反复新建、无法复用且不释放；需先查Threads_connected与max_connections比值及日志错误类型，再按Mac M1/Linux容器/云服务器环境分步修正hostname、启用deploy=1、补全PDO::ATTR_TIMEOUT/break_reconnect/INIT_COMMAND、校验.env生效并清理缓存。
PHP8应用突然报“too many connections”或持续卡在“MySQL server has gone away”，不是数据库扛不住，而是连接池在跨平台语义错位下反复新建、无法复用、又不释放——Mac M1、Linux容器、云服务器三类环境触发机制完全不同，必须按环境对症切。
确认是否真耗尽，还是假性卡死
进容器执行：mysql -h mysql -u root -p -e "SHOW STATUS LIKE 'Threads_connected';"。注意这里host必须填容器名mysql，不能写127.0.0.1——后者在容器内指向自己，不是数据库服务。
对比输出的Threads_connected和max_connections值。如果两者接近（如148/150），才是真耗尽；如果只有20但模型仍连不上，大概率是PDO没连通，不是池子满了。
再查日志：tail -n 50 runtime/log/*.log | grep -i "gone\|1040\|refused"。出现高频MySQL server has gone away，说明是wait_timeout导致的假性耗尽，不是连接数不够。
立即学习“PHP免费学习笔记（深入）”；
Docker环境专属修复路径
方法一：修正host与端口语义错位（90%故障根源）
进入config/database.php，找到MySQL配置块，在'hostname'字段里把'localhost'或'127.0.0.1'全部替换成数据库容器名，例如'mysql'；同时确保'hostport'是整数3306，不是字符串'3306'——后者会让PDO静默 fallback 到默认端口，连错实例。
方法二：强制启用部署模式复用连接（TP6唯一有效长连接方案）
在同个数据库配置块里，加入'deploy' => 1和'pool_size' => 20。注意：【deploy必须为整数1，不能写true或字符串'1'】；pool_size只控制空闲连接上限，不解决超时断连问题。
方法三：补全PDO超时与重连策略（专治“gone away”）
在同一配置块的'params'数组中，添加：PDO::ATTR_TIMEOUT => 5和PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4"；再加'break_reconnect' => true。这三项必须同时存在——缺任一，PDO建立新连接时可能卡住75秒系统超时，或重连失败后直接抛异常。
FPM与Swoole模式切换验证
第一步：确认当前运行模式
执行php think run是FPM模式，php think swoole才是协程模式。TP8无原生连接池，'pool' => true在FPM下完全被忽略，Db::connect()每次都是新PDO实例。
第二步：FPM下清理无效配置
删掉database.php中所有'pool'相关键值对，包括'pool' => ['enable' => true]或'persistent' => true——这些在FPM中不仅无效，还会加剧Sleep连接堆积。
第三步：Swoole下启用协程客户端
仅当启动命令为php think swoole且TP版本≥8.0.12时，Db::table()才会路由到Swoole\Coroutine\MySQL客户端。此时必须确保'type' => 'pdo'未覆盖驱动，且'params'中未误设PDO::ATTR_PERSISTENT => true——协程客户端自身管理连接复用，PDO持久化会引发冲突。
