FrankenPHP本身不内置数据库连接池，其连接耗尽问题源于PHP应用层未适配常驻内存模式导致的连接泄漏或复用失效；需通过显式启用部署模式、Worker级单例连接管理、禁用持久连接及MySQL层超时调优来解决。
FrankenPHP 本身不内置数据库连接池，它作为 PHP 运行时（基于 Swoole + PHP-CGI 的混合模型），其高并发下连接池耗尽问题，本质是 PHP 应用层未适配常驻内存运行模式导致的连接泄漏或复用失效——不是 FrankenPHP 的锅，而是传统写法在新环境里“水土不服”。核心优化方向是：让每个 Worker 进程独立、可控、可回收地管理连接，同时避免跨请求累积。
确认真实瓶颈：是连接真满了，还是连接“卡死”了？
先别急着改代码。登录 MySQL 执行：
-
查当前连接数：
SHOW STATUS LIKE 'Threads_connected';，再查上限：SHOW VARIABLES LIKE 'max_connections';。若接近上限（如 495/500），是真耗尽； -
查空闲僵尸连接：
SELECT id, user, host, db, time FROM information_schema.processlist WHERE command = 'Sleep' AND time > 120;。大量超 2 分钟的 Sleep 连接，说明应用没释放，或 PDO 复用逻辑失效； -
查错误日志关键词：
grep -i "gone\|1040\|refused" runtime/log/*.log | tail -20。高频出现 MySQL server has gone away，大概率是 wait_timeout 触发断连，而 FrankenPHP 的 Worker 没做重连检测。
强制连接复用：关闭自动新建，启用部署模式
FrankenPHP 要求显式开启连接复用，否则每个请求仍会新建 PDO 实例。修改 config/database.php（ThinkPHP）或对应数据库配置：
-
必须设
'deploy' => 1（整数 1，不是 true 或字符串）； -
主机名填容器名或真实 IP，不能写
localhost（Docker 内会解析失败，退化为 socket 连接且无法复用）； -
加关键参数：
'params' => [PDO::ATTR_TIMEOUT => 3, PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4"]，缺一不可； - 禁用
PDO::ATTR_PERSISTENT（FrankenPHP 下持久连接反而易泄漏，复用机制已足够）。
Worker 级连接生命周期管理
FrankenPHP 的每个 Worker 是长生命周期进程，必须主动管理连接归属：
立即学习“PHP免费学习笔记（深入）”；
- 所有
Db::connect()或new PDO()必须收口到一个单例工厂函数，按 host+db+user 生成唯一 key 缓存连接； - 在 Worker 启动时（如
frankenphp_init钩子）预热 1–3 个连接，避免首请求阻塞； - 在请求结束前（
register_shutdown_function或中间件terminate）检查连接是否 still alive，失效则 unset； - 禁止在 CLI 命令或定时任务中复用 Web Worker 的连接——它们生命周期不同，要单独建池。
兜底与监控：防漏、限流、可观测
再完善的逻辑也需防御性设计：
- MySQL 层临时扩容：
SET GLOBAL max_connections = 600;（注意内存占用，每 +100 连接约 +200MB）； - 调低超时：
SET GLOBAL wait_timeout = 180;，让空闲连接更快被 MySQL 清理，减少假性堆积； - 加连接数告警：用
SHOW STATUS LIKE 'Threads_connected';定期采集，超过阈值（如 400）触发钉钉/邮件； - 日志中标记连接来源：在 PDO 构造时传入
PDO::MYSQL_ATTR_INIT_COMMAND => "SET @app_worker_id = '" . getmypid() . "'"，出问题时可快速定位泄漏 Worker。
不复杂但容易忽略：FrankenPHP 下，连接池不是“开了就有效”，而是要靠配置硬约束 + 工厂强管控 + Worker 意识同步来落地。把连接当成 Worker 的本地资源来管，而不是每次请求都“重新申请”。
