ThinkPHP6连接PostgreSQL需避开三大陷阱：删掉'charset'=>'utf8'（PG不识别）、显式配置'hostport'=>5432（Docker中hostname填容器名而非localhost）、必须设置'params'=>[PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION]，否则PG错误被静默吞掉；同时确认PHP已加载pdo_pgsql扩展且pg_hba.conf放行连接。
ThinkPHP6 连接 PostgreSQL 能跑通，但默认配置下大概率会卡在 PDO::ATTR_ERRMODE 静默失败、pg_hba.conf 拒绝连接、或 charset=utf8 触发构造异常这三个地方。不是 TP 本身不支持，而是 PG 的协议细节和 TP 的默认假设存在错位。
确认 PHP 已加载 pdo_pgsql 扩展
没这个扩展，后面全白搭。不能只看 php -m | grep pgsql，得验证 PDO 是否真正识别到驱动：
- 运行
php -r "print_r(PDO::getAvailableDrivers());"，输出里必须含"pgsql" - Windows 下检查
php.ini是否启用两行：extension=php_pdo_pgsql.dll和extension=php_pgsql.dll - Linux/macOS 检查
extension=pdo_pgsql.so，并确认pdo.so在它之前加载 - Docker 环境里，镜像需显式安装
php-pgsql包（如apk add php82-pgsql），不是只装postgresql-client
database.php 中的 pgsql 配置必须避开三个典型陷阱
TP6 的 database.php 配置看着简单，但几个键值一错就连接失败，且错误信息极不友好：
-
'type' => 'pgsql'必须小写，写成Pgsql或PGSQL会 fallback 到 MySQL 驱动 - 删掉
'charset' => 'utf8'—— PostgreSQL 不认这个参数，PDO 构造时直接抛InvalidArgumentException，TP 会吞掉原始异常，只报空QueryException -
'hostport'必须显式写，哪怕用默认 5432；Docker 场景下'hostname'填容器名（如db），不能填localhost（那是指 PHP 容器自己） - 加
'params' => [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]，否则 PG 报错（比如 schema 不存在、权限不足）时 TP 只返回空结果，debug 成本翻倍
PostgreSQL 侧必须放行连接请求
TP6 配置全对，依然连不上？八成是 PostgreSQL 拦在了 pg_hba.conf。常见现象是报错：FATAL: no pg_hba.conf entry for host "x.x.x.x", user "xxx", database "xxx"
立即学习“PHP免费学习笔记（深入）”；
- 编辑 PostgreSQL 的
pg_hba.conf（通常在/var/lib/postgresql/data/pg_hba.conf或C:\Program Files\PostgreSQL\x.x\data\pg_hba.conf） - 在
# IPv4 local connections:后新增一行：host all all 0.0.0.0/0 md5（开发环境），生产环境请精确到应用服务器 IP 段 - 确认
postgresql.conf中listen_addresses = 'localhost,172.x.x.x'（Docker 网络需监听宿主或网桥地址），不能只留'localhost' - 改完执行
pg_ctl reload或重启 PostgreSQL 服务，SELECT * FROM pg_hba_file_rules();可验证规则是否生效
TP6 操作 PG 13+ 时字段默认值报错怎么办
用 TP6 查询表结构（比如调用 Db::query('SHOW TABLES') 或模型首次实例化）时，若 PostgreSQL 版本 ≥13，可能遇到：ERROR: column pg_attrdef.adsrc does not exist
- 这是 TP6 内置的
pgsql.sql元数据查询脚本未适配 PG 13+ 导致的，adsrc字段已被移除 - 临时绕过：在
config/database.php的连接配置中加'deploy' => 0（禁用部署模式，跳过部分元数据探测） - 根治方案：升级到 ThinkPHP 6.3+（已修复），或手动补丁——将
vendor/topthink/think-orm/src/db/connector/Pgsql.php中相关 SQL 改为用pg_get_expr(adbin, adrelid)替代adsrc - 注意：此问题不影响基础 CRUD，只影响自动获取字段类型、默认值等高级功能
最易被忽略的是 PDO::ATTR_ERRMODE 设置缺失——它让 PG 的真实错误（如密码错误、schema 不存在、函数不存在）彻底隐身，调试时只能看到空数组或空对象。只要加上这一行，90% 的“连不上”问题都能立刻定位到根源。
