thinkphp在docker中报“too many connections”或“mysql server has gone away”，本质是连接池语义错位导致反复新建、无法复用且不释放；需按mac m1/linux/云服务器三类环境对症处理，先查threads_connected与max_connections比值及日志错误类型，再分步修正hostname、启用deploy=1、补全pdo::attr_timeout/break_reconnect/init_command、校验.env生效并清理缓存。
ThinkPHP在Docker容器中运行时，模型层突然报“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导致的假性耗尽，不是连接数不够。
第二步：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秒系统超时，或重连失败后直接抛异常。
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
第三步：Mac M1 + Docker组合特供处理
Homebrew安装的MySQL默认只监听socket文件，不监听TCP端口。即使你写了127.0.0.1:3306，PHP容器也连不上。
进宿主机终端，执行brew services list | grep mysql确认MySQL已启动；再运行mysql --socket=/opt/homebrew/var/mysql/mysql.sock -u root -p -e "SHOW VARIABLES LIKE 'bind_address';"。如果返回bind_address是127.0.0.1，说明已开TCP；如果是*或空，需手动编辑/opt/homebrew/etc/my.cnf，在[mysqld]下加bind-address = 127.0.0.1并重启服务。
若改不动宿主机MySQL，就换方案：在Docker Compose里把MySQL容器暴露端口，并让PHP容器通过host.docker.internal访问——这个域名在Docker Desktop for Mac上自动解析为宿主机IP，绕过socket限制。
第四步：验证.env是否真正生效
在任意控制器里临时加一行：dump(env('DB_HOST')); exit;。如果输出null，说明.env根本没加载，所有配置修改都白做。
必须同时满足三个硬条件：【.env文件在项目根目录（和think命令同级）、APP_DEBUG=true、键名全大写加下划线（如DB_HOST）】。常见错误是把.env扔进app/或config/目录，或者写成db_host。
验证通过后，删掉那行dump，再清空runtime/cache/目录——ThinkPHP会缓存配置，不清理会导致旧配置继续生效。
第五步：紧急止血三命令（连接已满时立刻执行）
第一步：进MySQL容器，执行SHOW PROCESSLIST;，观察Command列。大量Sleep且Time > 60的连接，就是泄漏源头。
第二步：生成并执行批量KILL语句：SELECT CONCAT('KILL ',id,';') FROM information_schema.processlist WHERE Command='Sleep' AND Time > 60;。复制输出的所有KILL xxx;语句，逐条执行。
第三步：临时扩容连接上限：SET GLOBAL max_connections = 500;。注意：每增加100连接约多占200MB内存，别超过宿主机剩余内存的70%。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
