sqlstate[08006] connection timeout表明tcp连接阶段超时，需排查网络通路与连接参数：验证telnet连通性、检查postgresql.conf的listen_addresses和端口、dsn中显式添加connect_timeout=3、确保启用pdo_pgsql扩展、避免localhost改用ip、禁用charset参数、排除dns延迟或scram认证兼容性问题。
![thinkphp连接postgresql报sqlstate[08006] connection timeout怎么解决](https://img.php.cn/upload/article/001/503/042/179109457991163.png?x-oss-process=image/resize,p_40)
报 SQLSTATE[08006] connection timeout，说明 PHP 连接 PostgreSQL 时在建立 TCP 连接阶段就超时了，不是认证失败、也不是查询出错，而是根本没连上服务器。这个问题要从网络通路和连接参数两方面排查，不能只改数据库配置。
确认 PostgreSQL 是否真正可访问
先绕过 ThinkPHP，用最基础方式验证连通性：
- 在 PHP 所在机器上执行：
telnet 192.168.1.100 5432（把 IP 和端口换成你实际配置的），如果连不上，说明是网络层问题：防火墙拦截、服务未监听、IP/端口写错或 Docker 容器网络不通 - Docker 环境下，
hostname必须填 PostgreSQL 容器名（如db），不能填localhost——那是指 PHP 容器自己 - 检查 PostgreSQL 服务端配置：
postgresql.conf中listen_addresses是否包含该 IP（比如'0.0.0.0'或具体内网地址），port是否与配置一致
缩短并显式控制建连超时
PHP 的 PDO 默认不设连接超时，Linux 下可能傻等 75 秒才报错。必须主动干预：
- 在 ThinkPHP 的
database.php中，PostgreSQL 的 DSN 字符串里加上connect_timeout=3，例如：pgsql:host=192.168.1.100;port=5432;dbname=test;connect_timeout=3 - 确保
type是小写'pgsql'，大小写错误会 fallback 到 MySQL 驱动，导致 DSN 解析异常 - 删掉
'charset' => 'utf8'—— PostgreSQL 不识别这个参数，PDO 构造时直接抛错，TP 可能静默吞掉原始异常，只显示模糊的连接失败
检查 PHP 扩展与驱动兼容性
这个错误也可能源于底层驱动能力不足：
- 运行
php -r "print_r(PDO::getAvailableDrivers());"，输出必须含"pgsql"；若没有，说明pdo_pgsql扩展未启用或安装 - WAMP/XAMPP 等集成环境容易出现
libpq版本过低问题，报错中带SCRAM authentication requires libpq version 10 or above就是典型表现。解决方法是升级 PHP（连带升级其内置的 libpq）或手动替换高版本libpq.dll/.so - Greenplum 或 openGauss 等兼容库若启用了
scram-sha-256认证，而 PHP 的 pgsql 扩展版本太低，也会表现为连接超时（实际是握手卡死）。此时需服务端降级为md5认证
排除 DNS 解析延迟干扰
如果 DSN 中用的是域名而非 IP，DNS 查询失败或缓慢会导致看似“超时”：
- 把
hostname改成直连 IP 地址，例如'hostname' => '192.168.1.100' - 避免使用
localhost—— 某些系统会优先走 Unix socket，而 PostgreSQL 可能未配置本地 socket 监听，导致阻塞 - 如必须用域名，可在服务器 hosts 文件中做静态解析，绕过 DNS 查询
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
