PHP 8.1+Lumen 8.6+PostgreSQL 11测试环境PDO连接泄漏排查求助

关键排查方向 #

• PHP数据库扩展版本核对
  问题仅出现在部分机器，优先对比问题机器与正常机器的pgsql/pdo_pgsql扩展版本。执行以下命令确认版本一致：

  php -m | grep pgsql
  php -i | grep -A 10 "pdo_pgsql"
  

  旧版本的PostgreSQL扩展可能存在连接回收机制的bug，是这类环境差异问题的常见诱因。

• PHPUnit进程隔离配置检查
  打开phpunit.xml查看processIsolation配置：

  <phpunit processIsolation="false">
  

  若未开启进程隔离，所有测试用例会共享同一个PHP进程环境，连接池可能无法被正确清理。临时将其改为processIsolation="true"，重新运行测试观察连接数变化。

• 全连接遍历销毁
  目前仅关闭了tenant连接，可能存在其他未处理的连接实例。修改测试基类的tearDown方法，遍历并销毁所有数据库连接：

  public function tearDown(): void
  {
      $dbManager = $this->app->make('db');
      foreach ($dbManager->getConnections() as $name => $connection) {
          $connection->disconnect();
          $dbManager->forgetConnection($name);
      }
      parent::tearDown();
  }
  

• PostgreSQL连接状态分析
  在问题机器上执行SQL查看连接详情：

  SELECT pid, usename, application_name, state FROM pg_stat_activity;
  

  通过application_name确认是否为PHPUnit测试进程的连接，state字段可判断连接是处于活跃状态还是闲置未释放，缩小排查范围。

• 容器单例绑定隐患
  检查项目中是否有单例服务持有数据库连接实例。如果服务通过singleton绑定，Lumen容器在测试循环中不会自动销毁单例，导致连接被长期持有。可在tearDown中手动销毁相关单例：

  $this->app->instance('your-singleton-service-id', null);
  

• PHP配置参数核查
  检查问题机器php.ini中的关键参数：

  • pgsql.allow_persistent：若开启持久化连接，测试环境下会导致连接无法正常释放，需设置为Off。
  • max_execution_time：如果设置过短，测试进程可能未完成连接清理就被强制终止，引发泄漏。

快速定位测试用例 #

给测试基类添加连接计数日志，在setUp和tearDown中记录当前连接数：

public function setUp(): void
{
    parent::setUp();
    $count = $this->app->make('db')->connection('tenant')
        ->selectOne("SELECT count(*) FROM pg_stat_activity WHERE usename = 'your-db-username'")->count;
    error_log("Start test {$this->getName()}: Connection count = {$count}");
}

public function tearDown(): void
{
    // 原有销毁逻辑
    $count = $this->app->make('db')->connection('tenant')
        ->selectOne("SELECT count(*) FROM pg_stat_activity WHERE usename = 'your-db-username'")->count;
    error_log("End test {$this->getName()}: Connection count = {$count}");
    parent::tearDown();
}

通过日志可以快速定位是哪个测试用例导致连接数异常增长。

内容的提问来源于stack exchange，提问作者NoLongerBreathedIn