php 8.4尚未发布，实际使用php 8.3，连接gaussdb必须用pdo_pgsql驱动且type设为'pgsql'；需启用pgsql扩展、删除dsn中charset参数、手动创建pgsql_type和table_msg函数、设置errmode_exception、显式指定端口26000及schema。
PHP 8.4 尚未发布（截至 2026 年 7 月），你实际用的是 PHP 8.3；连接 GaussDB 的方式与 PHP 8.3 完全一致，且必须走 pdo_pgsql 驱动——GaussDB 不是独立数据库类型，它兼容 PostgreSQL 协议，type => 'gaussdb' 这种写法会直接让框架 fallback 到 mysql 驱动并报错。
为什么不能用 mysql 或自定义 driver 名称
ThinkPHP/Laravel 等主流框架只识别标准驱动名：mysql、pgsql、sqlsrv。GaussDB 基于 openGauss，而 openGauss 兼容 PostgreSQL 协议，所以唯一可行路径是 pgsql。写成 gaussdb 或 opengauss 后，框架无法匹配驱动类，最终尝试调用已移除的 mysql_connect()（PHP 8+ 已彻底删除），抛出 Fatal error: Uncaught Error: Call to undefined function mysql_connect()。
-
type配置项必须为pgsql，不能是其他字符串 - 验证是否启用扩展：运行
php -m | grep pgsql，必须同时输出pdo_pgsql和pgsql - 若用 Docker，
host填容器名（如gaussdb），不要填localhost（会走 host network socket，大概率失败）
DSN 中必须删掉 charset 参数
PostgreSQL 协议不接受客户端在 DSN 中声明 charset=utf8，GaussDB 更严格——保留该参数会导致 PDO 构造阶段抛出 InvalidArgumentException，而 ThinkPHP 常静默吞掉此异常，只返回空 QueryException，根本看不到真实错误源。
- 配置中整行
'charset' => 'utf8'必须彻底删除，不是注释，也不是改成utf8mb4 - GaussDB 服务端字符集由初始化集群时指定（默认 UTF8），客户端无需、也不能干预
- 验证方法：临时加个非法键如
'xxx' => 1，如果报错变成明确的InvalidArgumentException，说明 PDO 构造已进入，原charset就是根因
必须手动创建 pgsql_type 和 table_msg 函数
ThinkPHP 的 pgsql 连接器在获取字段元数据（如 Db::getFields()）时，硬依赖两个 PostgreSQL 扩展函数：pgsql_type() 和 table_msg()。GaussDB 默认不提供它们，导致字段类型全映射为 string，save() 时可能因类型不匹配失败。
- 用
gsql或psql登录 GaussDB，执行thinkphp/library/think/db/connector/pgsql.sql全部语句 - 注意替换 SQL 中的
publicschema 为你实际使用的 schema（如gaussdb） - 重点确认
CREATE OR REPLACE FUNCTION pgsql_type()和CREATE TYPE tablestruct AS ()成功执行；若报permission denied，需 DBA 授予CREATE FUNCTION权限
连接参数必须显式设 ERRMODE_EXCEPTION
GaussDB 在 schema 不存在、函数未定义、权限不足等场景下，返回标准 PostgreSQL 错误码（如 42704、42501）。但 ThinkPHP 默认用 PDO::ERRMODE_SILENT，错误被静默吞掉，query() 返回 false，prepare() 返回 null，调试时毫无线索。
- 配置中必须加
'params' => [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION] - 端口必须显式写
hostport（GaussDB 默认是26000，不是 PostgreSQL 的5432） - 密码含特殊字符（如
@、/）时，必须用urlencode()处理后再填入配置
最易被忽略的点：GaussDB 的 schema 默认是 public，但信创部署常预设为 gaussdb 或其他名称；不显式指定 schema，SELECT * FROM users 会查 public.users 而不是你真正建表的 schema，报 relation "users" does not exist——这和数据库连没连上无关，纯属 schema 错配。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
