PostgreSQL驱动未生效主因是PHP缺pdo_pgsql扩展，Linux需安装php-pgsql包，Windows需启用php_pdo_pgsql.dll；TP配置须设type为pgsql、hostname为127.0.0.1、勿加charset；PDO错误模式必须设为PDO::ERRMODE_EXCEPTION。
PostgreSQL 驱动没装上，pdo_pgsql 扩展始终不生效
ThinkPHP 启动报 Driver not found: pgsql 或 Class 'PDO' not found，大概率不是 TP 配置问题，而是 PHP 环境缺扩展。Linux 下常漏掉 php-pgsql 包；Windows 则容易只改了 php.ini 但没开对那个 extension=php_pdo_pgsql.dll 行——注意不是 php_pgsql.dll，少 pdo_ 前缀就白配。
验证方式很简单：php -m | grep pdo 看输出里有没有 pdo_pgsql；或者写个 phpinfo() 页面搜关键词。没出现就别往下调配置了。
- Ubuntu/Debian：运行
sudo apt install php-pgsql，然后重启 PHP-FPM 或 Apache - CentOS/RHEL：用
sudo yum install php-pgsql（或dnf），确认 PHP 版本匹配（如php81-php-pgsql） - Windows：检查
php.ini中extension_dir路径是否正确，且extension=php_pdo_pgsql.dll这行前面没被;注释
ThinkPHP 的 database.php 里怎么填 PostgreSQL 连接参数
TP6/TP7 的数据库配置不能照搬 MySQL 写法。PostgreSQL 对端口、数据库名、用户名更敏感，而且不支持 charset 参数（字符集由服务端控制，客户端设了也无效）。
关键点是 type 必须为 pgsql，hostname 和 database 不能为空，host 不要写成 localhost——它会走 Unix socket，而默认 PostgreSQL 只监听 127.0.0.1。直接写 127.0.0.1 更稳。
立即学习“PHP免费学习笔记（深入）”；
'default' => [
'type' => 'pgsql',
'hostname' => '127.0.0.1',
'database' => 'myapp',
'username' => 'postgres',
'password' => 'xxx',
'hostport' => '5432',
'prefix' => '',
]
-
hostport默认是5432，但如果改过 PostgreSQL 的postgresql.conf，必须显式写对 - 不要加
'charset' => 'utf8'—— PG 不认这个，加了反而可能触发 PDO 构造失败 - 如果用 Docker，
hostname得填容器名（如db），不是localhost
PDO::ATTR_ERRMODE 设错导致错误静默或异常中断
PostgreSQL 报错时，如果 PDO 没设好错误模式，TP 可能吞掉真实错误信息，只抛出空 QueryException，查半天发现是权限或 schema 不存在。
ThinkPHP 默认已设 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION，但如果你手动 new PDO 或改过底层连接逻辑，就得自己补上。否则 PG 的 NOTICE（比如隐式类型转换警告）会被忽略，而某些致命错误（如序列不存在）可能只返回 false 而不抛异常。
- 确认
think\db\connector\Pgsql类中connect方法里是否含$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION) - 若自定义连接，务必在
new PDO()后立刻设置，顺序不能错：先连上，再设属性 - PG 的
standard_conforming_strings = on是默认值，不必在 DSN 里重复写options='--client_encoding=UTF8'，TP 已自动处理
连接字符串（DSN）里哪些参数真有用，哪些纯属干扰
很多人往 DSN 里塞一堆参数，比如 options='--client_encoding=UTF8'、sslmode=require，结果连不上还怀疑驱动。其实 ThinkPHP 的 Pgsql 连接器会自动拼基础 DSN，你只需要管好配置数组里的字段，其他靠它兜底。
真正需要干预的只有三种情况：SSL 连接、自定义 search_path、超时控制。其余像 charset、application_name（除非监控强依赖）都非必需。
- SSL 连接：加
'params' => [PDO::ATTR_SSL_MODE => 'require']，而不是塞进 DSN 字符串 - 指定 schema：在查询前执行
SET search_path TO my_schema，或在配置里加'execute' => ['SET search_path TO my_schema'] - 连接超时：用
'params' => [PDO::ATTR_TIMEOUT => 5]，单位秒；PG 自身的connect_timeout参数在 DSN 里无效，PHP PDO 不解析它
复杂点在于 PostgreSQL 的权限模型和 schema 分离比 MySQL 严得多。连得上不代表能查——public schema 权限、用户默认 schema、甚至表名大小写（双引号包裹才区分）都可能让一个 Db::table('user') 直接报 relation "user" does not exist。这些不在连接层解决，得回数据库里逐条核对。
