排查 MySQL 连接不足需先查 Threads_connected 与 max_connections 是否真打满，再检查 max_user_connections、持久连接配置、flock 锁争用、连接池参数协同及 FrankenPHP 环境变量重置。
查 Threads_connected 是否真打满
别一看到 Too many connections 就改 max_connections。先连 MySQL 执行：SHOW GLOBAL STATUS LIKE 'Threads_connected';SHOW VARIABLES LIKE 'max_connections';
如果前者是 148、后者是 151，那确实是满了；但如果前者只有 80 却报错，大概率是应用没配好连接复用，或者被 max_user_connections 限制了——查：SELECT user, host, max_connections FROM mysql.user;，尤其注意 root 或应用专用账号的限制值。
Symfony/Laravel 在 FrankenPHP worker 模式下必须设持久连接
FrankenPHP 启用 php_worker 后，PHP 进程常驻，但 Doctrine/Laravel 默认每请求新建 PDO 连接且不显式关闭，几十个并发就能耗尽 MySQL 连接池。
必须在 config/packages/doctrine.yaml 或 config/packages/framework.yaml 中强制配置：doctrine.dbal.connections.default.options: { pdo::ATTR_PERSISTENT: true, pdo::ATTR_EMULATE_PREPARES: false }
不加这行，pdo::ATTR_PERSISTENT: true 就只是摆设；同时确认 max_connections 在 MySQL 侧至少是应用 worker 数 × 2～3，比如 8 个 worker 建议设到 32 起步。
flock 文件锁卡住也会间接拖垮数据库连接
很多“连接不够”的表象，实际是请求卡在文件锁上，导致数据库连接迟迟得不到释放。FrankenPHP 多 worker 常驻后，flock($fp, LOCK_EX) 若没配 LOCK_NB 或没在 finally 里 flock($fp, LOCK_UN)，一个 worker 卡住，其他 worker 就排队等锁，进而所有请求都堆在 DB 连接等待队列里。
实操建议：
• 改用非阻塞加锁：flock($fp, LOCK_EX | LOCK_NB)
• 加重试逻辑，最多等 100ms，超时直接返回 503
• 锁文件路径固定、不放 NFS、不 rename 或 unlink 锁文件
• 更推荐按业务键拆分锁（如 storage/locks/inventory_123.lock），避免全局锁争用
连接池参数不配套等于没池
光设 pool_size: 16 不顶用。关键参数必须成对出现：
• connection-timeout: 3000（毫秒）：防止线程无限等待连接
• idle-timeout: 60000（毫秒）：60 秒内空闲连接自动回收，避免 DB 端已断开但池子还留着
• leak-detection-threshold: 60000：检测超过 60 秒未归还的连接，主动回收
注意：idle-timeout 设太长（比如 30 分钟），MySQL 的 wait_timeout（默认 8 小时）虽没到，但中间网络抖动或防火墙 kill 掉连接后，池子仍认为连接有效，下次取出就报错，反而加剧连接创建压力。
立即学习“PHP免费学习笔记（深入）”；
最易被忽略的是：FrankenPHP worker 进程不会自动重置 $_SERVER 和 $_REQUEST，某些中间件或日志组件会因此复用旧连接句柄，或触发异常重连。入口脚本开头必须手动清空：$_SERVER = []; $_REQUEST = []; $_GET = []; $_POST = [];，否则连接泄漏会静默发生，监控也看不出明显异常。
