Laravel使用PostgreSQL并行测试时触发beginTransaction()调用异常

• 并行测试的连接竞态：Laravel并行测试会为每个测试进程创建独立测试数据库，但LazilyRefreshDatabase的延迟初始化特性，可能导致多进程同时触发连接初始化，出现竞态条件，使得部分进程的连接实例未完成初始化就被调用事务方法，最终getPdo()返回null。
• PostgreSQL连接回收/限制：并行场景下大量进程频繁创建、销毁连接，可能触发PostgreSQL的连接超时回收机制，或是达到max_connections限制，导致Laravel连接实例持有的Pdo对象失效，调用getPdo()时返回null。
• 全局状态干扰：部分测试存在未清理的静态/全局状态，在并行进程间干扰连接实例的正常初始化，导致Pdo对象未被正确赋值。

• 追踪连接异常时机：临时修改PostgresConnection的getPdo()方法，添加日志记录进程ID与调用栈，定位触发null返回的具体场景：

  public function getPdo()
  {
      $pdo = parent::getPdo();
      if (is_null($pdo)) {
          error_log("getPdo()返回null，进程ID：" . getmypid() . "\n调用栈：" . print_r(debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 10), true));
      }
      return $pdo;
  }
  

• 提前初始化连接：在测试类的setUp()中主动触发连接初始化，规避延迟加载的竞态：

  protected function setUp(): void
  {
      parent::setUp();
      // 强制初始化数据库连接
      DB::connection()->getPdo();
  }
  

• 调整PostgreSQL连接配置：修改config/database.php中的pgsql参数，添加连接保活配置防止连接被回收：

  'pgsql' => [
      // 原有配置
      'keepalives' => 1,
      'keepalives_idle' => 60,
      'keepalives_interval' => 10,
      'keepalives_count' => 5,
  ],
  

  同时调高PostgreSQL配置文件postgresql.conf中的max_connections参数，避免并行测试时连接耗尽。
• 替换刷新trait验证：将LazilyRefreshDatabase替换为RefreshDatabase，后者会在每个测试前主动刷新并初始化连接，验证是否因延迟初始化导致问题。
• 排查全局状态污染：检查测试代码中的静态变量、单例实例，确认是否持有数据库连接，需在tearDown()中清理这类状态，避免进程间干扰。

内容的提问来源于stack exchange，提问作者Gonçalo Marrafa