thinkphp 8 连接 postgresql 必须启用 pdo_pgsql 扩展、删除 charset 配置、设置 pdo::attr_errmode => pdo::errmode_exception，并在 docker 中使用容器名作 hostname。
ThinkPHP 8 默认不带 PostgreSQL 支持，必须手动启用 PHP 的 pdo_pgsql 扩展，且配置中不能写 charset —— 写了反而导致 PDO 构造失败，连接直接报空 QueryException。
确认 PHP 已加载 pdo_pgsql 扩展
TP8 依赖 PDO，但 php -m 输出里没 pdo_pgsql 就一定连不上：
- Linux（Debian/Ubuntu）：
sudo apt install php-pgsql，然后sudo systemctl restart php-fpm或apache2 - Windows：检查
php.ini是否已启用这两行（取消分号）：extension=php_pdo_pgsql.dll和extension=php_pgsql.dll；若提示找不到libpq.dll，需在 Apache 的httpd.conf中加LoadFile "C:/php/libpq.dll" - 用
php -r "print_r(PDO::getAvailableDrivers());"验证输出含pgsql
数据库配置里禁用 charset 键
PostgreSQL 不识别 charset 参数，TP8 会把它塞进 PDO DSN，触发底层构造失败 —— 表现为“连接成功但查表就抛空异常”，日志里看不到真实错误：
- ❌ 错误写法：
'charset' => 'utf8'或'charset' => 'utf8mb4' - ✅ 正确写法：直接删掉该键，或显式设为
null（TP8 会跳过） - DSN 实际生成效果应为：
pgsql:host=127.0.0.1;port=5432;dbname=myapp;user=postgres;password=xxx—— 里面不含charset
Docker 环境下 hostname 必须填容器名
本地开发用 Docker Compose 跑 PostgreSQL 时，hostname 写 localhost 一定失败，因为 PHP 进程在另一个容器里：
- ✅ 正确值示例：
'hostname' => 'pg'（对应docker-compose.yml中 service 名为pg） - ⚠️ 注意端口映射：宿主机的
5432映射到容器内仍是5432，但 TP8 配置里的hostport是指容器内端口，一般保持5432即可 - 如果容器间网络不通，先
docker exec -it your_php_container ping pg确认连通性
PDO 错误模式必须设为 ERRMODE_EXCEPTION
默认 PDO::ERRMODE_SILENT 会让 PostgreSQL 的真实错误（如 schema 不存在、权限不足、字段类型不匹配）被 TP8 吞掉，只抛出无意义的 QueryException：
- 在数据库配置数组中加入：
'params' => [ \PDO::ATTR_ERRMODE => \PDO::ERRMODE_EXCEPTION ] - 否则你看到的可能是：
SQLSTATE[XX000]: >: 7 ERROR: relation "user" does not exist这类原始报错被截断成空异常 - 配合
'debug' => true才能真正看到执行的 SQL 和绑定参数
最容易被忽略的是 charset 键和 PDO::ATTR_ERRMODE 设置 —— 它们不会导致连接建立失败，却会让后续所有查询静默崩坏，排查时极易误判为 SQL 或模型问题。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
