Laravel升级PHP8.3后无法连接Postgres数据库求助

排查方向1：PHP 8.3与PostgreSQL扩展兼容性 #

• 确认新服务器上安装的pgsql和pdo_pgsql扩展版本适配PHP8.3。执行命令查看：

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

• 若扩展版本过旧，卸载后重新安装对应PHP8.3版本的扩展（以Debian/Ubuntu为例）：

  apt remove php-pgsql
  apt install php8.3-pgsql
  

• 安装完成后重启PHP-FPM或Web服务器（如Nginx/Apache）。

排查方向2：PostgreSQL服务器连接限制 #

• 检查PostgreSQL服务器的max_connections参数是否达上限，登录数据库执行：

  SHOW max_connections;
  SELECT count(*) FROM pg_stat_activity;
  

• 若当前连接数接近或等于上限，修改postgresql.conf中的max_connections值，重启PostgreSQL服务生效。
• 同时检查pg_hba.conf，确认新服务器IP已被允许连接，认证规则（如md5）配置正确。

排查方向3：新服务器网络端口耗尽问题 #

• 排查本地端口是否因短时间大量连接耗尽，执行命令查看：

  netstat -tanp | grep TIME_WAIT | wc -l
  sysctl net.ipv4.ip_local_port_range
  

• 若TIME_WAIT状态连接过多，调整内核参数加速端口回收：

  sysctl -w net.ipv4.tcp_tw_reuse=1
  sysctl -w net.ipv4.tcp_tw_recycle=1
  sysctl -w net.ipv4.tcp_fin_timeout=30
  

• 也可扩大本地端口范围：

  sysctl -w net.ipv4.ip_local_port_range="1024 65535"
  

• 上述修改可写入/etc/sysctl.conf实现永久生效。

排查方向4：Laravel数据库配置优化 #

• 检查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' => 'prefer',
      'options' => [
          PDO::ATTR_TIMEOUT => 10,
          PDO::PGSQL_ATTR_INIT_COMMAND => 'SET NAMES utf8'
      ],
      'persistent' => false,
  ],
  

• 开启persistent => false禁用持久连接，避免旧连接残留问题。

排查方向5：网络链路稳定性验证 #

• 在新服务器上测试PostgreSQL端口连通性与链路稳定性：

  nc -zv <postgres-server-ip> 5432
  ping -c 100 <postgres-server-ip>
  

• 若存在丢包或不稳定，联系运维排查路由、负载均衡器等网络链路配置。

内容的提问来源于stack exchange，提问作者Leo Starić