ThinkPHP如何做数据库连接池连接泄露告警_ThinkPHP长时间未归还连接通知【操作】-ThinkPHP-PHP中文网

ThinkPHP 无内置连接池，连接泄露主因是事务未提交/回滚或对象生命周期异常延长；可通过数据库 sleep 连接、自定义 TrackedConnection 监控借用时长、Swoole 下强制 close 和禁用持久连接来发现与防范。

thinkphp如何做数据库连接池连接泄露告警_thinkphp长时间未归还连接通知【操作】

ThinkPHP 连接池里连接没还回去，怎么发现？

ThinkPHP 本身不内置连接池，所谓“连接池”其实是 PDO 连接复用 + 连接管理（比如 think\db\Connection 的连接缓存机制），真正的连接泄露发生在：请求结束时，Connection 实例未被销毁、或事务未提交/回滚导致连接被长期占用。

最直接的告警信号是数据库端出现大量 sleep 状态连接，且持续时间远超 PHP 脚本生命周期（比如 >30s）。这时不是 TP “漏还”，而是你代码里有地方没走完释放流程。

检查是否在中间件、命令行任务、异步回调中手动调用了 startTrans() 却没配对 commit() 或 rollback()
确认有没有把 Db 实例赋值给全局静态变量或 static 属性，导致连接对象生命周期被意外延长
避免在闭包或协程（如 Swoole）中直接复用 Request 生命周期外的 Db 对象 —— ThinkPHP 6.1+ 默认不支持协程安全连接复用

怎么让 TP 主动检测连接占用超时？

TP 没提供“连接借用超时自动告警”机制，但你可以通过钩子 + 自定义连接类实现轻量监控。核心思路是在连接被取出时打上时间戳，在连接归还前校验耗时。

示例做法（适用于 TP 6.x）：

// app/common/monitor/TrackedConnection.php
class TrackedConnection extends \think\db\Connection
{
    protected $borrowTime = 0;
<pre class="brush:php;toolbar:false;">public function getConnection($config = [])
{
    $conn = parent::getConnection($config);
    $this->borrowTime = microtime(true);
    return $conn;
}

protected function close()
{
    if ($this->borrowTime > 0 && (microtime(true) - $this->borrowTime) > 10.0) {
        \think\facade\Log::warning('db connection borrowed too long', [
            'duration' => round(microtime(true) - $this->borrowTime, 2),
            'trace' => debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 5)
        ]);
    }
    $this->borrowTime = 0;
    parent::close();
}

}