PHP PDO连接PostgreSQL异常问题排查（Docker环境）

报错信息 #

SQLSTATE[08006] [7] could not send SSL negotiation packet: Resource temporarily unavailable (Connection: pgsql, SQL: (select * from ........)

环境配置 #

• Laravel v10及以上版本
• PHP 8.3及以上版本
• Docker（搭载最新版Ubuntu）

已排查结果 #

• 通过iptraf工具检测发现：PDO无法建立PostgreSQL连接，且iptraf未记录PDO的连接请求
• 使用pg_connect()可正常连接并执行查询，数据库管理工具也能正常连接
• 问题在开发、生产环境均存在，但整套部署在虚拟机环境中可正常运行

原因分析与解决步骤 #

1. Laravel数据库连接池配置异常 #

Laravel默认的连接复用机制在Docker网络环境下可能出现连接失效后无法重建的情况。

修改config/database.php中的PostgreSQL连接配置，添加连接管控参数：

'pgsql' => [
    'driver' => 'pgsql',
    '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' => env('DB_SSLMODE', 'prefer'),
    'options' => extension_loaded('pdo_pgsql') ? array_filter([
        PDO::PGSQL_ATTR_DISABLE_PREPARES => true,
        PDO::ATTR_TIMEOUT => 5,
        PDO::ATTR_PERSISTENT => false, // 禁用持久连接，避免Docker网络下连接泄漏
    ]) : [],
],

2. Docker网络TCP参数优化 #

Docker容器的网络栈对TCP连接复用的处理可能导致闲置连接被强制关闭，且未被Laravel检测到。

在Dockerfile中添加TCP内核参数调整：

RUN echo "net.ipv4.tcp_keepalive_time = 60" >> /etc/sysctl.conf \
    && echo "net.ipv4.tcp_keepalive_intvl = 10" >> /etc/sysctl.conf \
    && echo "net.ipv4.tcp_keepalive_probes = 3" >> /etc/sysctl.conf \
    && sysctl -p

3. PHP PDO扩展与PostgreSQL客户端兼容性问题 #

PHP 8.3的pdo_pgsql扩展可能与Ubuntu镜像中最新PostgreSQL客户端库存在兼容问题，导致SSL协商失败。

在Dockerfile中指定安装兼容版本的PostgreSQL客户端：

RUN apt-get update && apt-get install -y --no-install-recommends postgresql-client-15 \
    && rm -rf /var/lib/apt/lists/*

4. 临时禁用SSL连接（验证用） #

若业务无需SSL加密，可临时禁用SSL连接确认问题根源：
修改.env文件：

DB_SSLMODE=disable

验证方法 #

修改配置后重启Docker容器，发送多轮连续请求，检查报错是否消失；同时用iptraf再次检测PDO连接记录是否正常生成。

内容的提问来源于stack exchange，提问作者Harun Barış Bulut