Laravel 10启用PDO持久化连接后迁移报错的解决方案咨询

问题描述 #

启用PDO持久化连接（添加PDO::ATTR_PERSISTENT => true到database.php的pgsql配置）后，执行php artisan db:migrate触发以下错误：

PDOException 

  SQLSTATE[HY000]: General error: PDO::ATTR_STATEMENT_CLASS cannot be used with persistent PDO instances

  at vendor/doctrine/dbal/lib/Doctrine/DBAL/Connection.php:210
    206▕                 throw Exception::invalidPdoInstance();
    207▕             }
    208▕ 
    209▕             $this->_conn = $params['pdo'];
  ➜ 210▕             $this->_conn->setAttribute(PDO::ATTR_STATEMENT_CLASS, [PDODriverStatement::class, []]);
    211▕             unset($this->params['pdo']);
    212▕         }
    213▕ 
    214▕         if (isset($params['platform'])) {

      +10 vendor frames 
  11  database/migrations/2023_07_07_055322_modify_reports_table.php:34
      Illuminate\Support\Facades\Facade::__callStatic()

原因 #

PDO规范明确禁止在持久化连接上修改ATTR_STATEMENT_CLASS属性，而Laravel依赖的Doctrine DBAL在初始化连接时会强制设置该属性，两者冲突导致报错。

解决方案 #

方案1：区分环境启用持久化连接（推荐） #

迁移等CLI命令不需要持久化连接，通过判断运行环境来配置：

'pgsql' => [
    // 保留原有配置项
    'driver' => 'pgsql',
    'url' => env('DATABASE_URL'),
    'host' => env('DB_HOST', '127.0.0.1'),
    'port' => env('DB_PORT', '5432'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    'charset' => 'utf8',
    'prefix' => '',
    'prefix_indexes' => true,
    'search_path' => 'public',
    'sslmode' => 'disable',
    'options' => extension_loaded('pdo_pgsql') ? [
        // 仅Web请求启用持久化连接
        PDO::ATTR_PERSISTENT => php_sapi_name() !== 'cli',
    ] : [],
],

这样Web请求用持久化连接提速，CLI命令用普通连接避免报错。

方案2：自定义连接器跳过属性设置 #

如果需要CLI也用持久化连接，可自定义数据库连接器：

1. 创建app/Database/CustomPostgresConnector.php：

<?php

namespace App\Database;

use Illuminate\Database\Connectors\PostgresConnector;
use Illuminate\Database\PostgresConnection;

class CustomPostgresConnector extends PostgresConnector
{
    protected function createConnection($dsn, array $config, array $options)
    {
        $pdo = parent::createConnection($dsn, $config, $options);
        
        // 持久化连接跳过ATTR_STATEMENT_CLASS设置
        if (!($options[PDO::ATTR_PERSISTENT] ?? false)) {
            $pdo->setAttribute(\PDO::ATTR_STATEMENT_CLASS, [\Doctrine\DBAL\Driver\PDO\Statement::class, []]);
        }

        return new PostgresConnection($pdo, $config['database'], $config['prefix'], $config);
    }
}

2. 在App\Providers\AppServiceProvider的register方法中替换默认连接器：

public function register()
{
    $this->app->extend('db.connector.pgsql', function () {
        return new \App\Database\CustomPostgresConnector();
    });
}

关于取消PDO::ATTR_STATEMENT_CLASS的建议 #

对于持久化连接，必须取消该属性的设置，这是PDO的硬性限制。取消后不会影响Laravel核心功能，只是无法使用Doctrine自定义的Statement类，常规CRUD、查询构建器等操作完全不受影响。

内容的提问来源于stack exchange，提问作者Avnee.Angel