PDO_MYSQL 连 GaussDB(for openGauss) 必然失败，因其内核基于 PostgreSQL，不兼容 MySQL 协议，握手即被拒；必须改用 PDO_PGSQL 扩展，配置 type=>'pgsql'，启用 scram-sha-256 认证（PHP≥8.0），并适配 SQL 语法。
ThinkPHP 默认用 PDO_MYSQL 扩展连 GaussDB(for openGauss) 会失败，不是因为连不上，而是协议和行为不匹配——GaussDB(for openGauss) 内核基于 PostgreSQL，不能走 MySQL 驱动；必须切换为 PDO_PGSQL，并改用 PostgreSQL 认证方式（如 scram-sha-256）。
为什么 PDO_MYSQL 连 GaussDB(for openGauss) 必然失败
GaussDB(for openGauss) 虽然名字带 “MySQL” 的变体（如 GaussDB(for MySQL)），但 GaussDB(for openGauss) 是另一条技术路线：它内核源自 PostgreSQL 9.2.4，完全不兼容 MySQL 协议。用 PDO_MYSQL 去连，PDO 底层发的是 MySQL 二进制协议包，GaussDB 直接拒绝连接，报错通常是：
SQLSTATE[08006] [7] FATAL: unsupported frontend protocol 1234.5679: server supports 2.0 to 3.0
这不是账号密码错，也不是网络不通，是协议握手阶段就被拒了。
常见误操作包括：
立即学习“PHP免费学习笔记（深入）”；
- 在
config/database.php中照搬 MySQL 配置，只改了hostname和port - 以为加
'params' => [\PDO::ATTR_EMULATE_PREPARES => true]就能救活（这招对 GaussDB(for MySQL) 有效，对 GaussDB(for openGauss) 完全无效） - 没装
pdo_pgsql扩展，却在配置里写'type' => 'pgsql'，导致 ThinkPHP 启动时报Driver [pgsql] not supported
ThinkPHP 6.x 正确配置 PDO_PGSQL 连 GaussDB(for openGauss)
必须确认三点：扩展已启用、驱动类型设对、连接参数适配 PostgreSQL 协议。
- 先验证 PHP 已加载
pdo_pgsql：php -m | grep pgsql应输出pdo_pgsql和pgsql - 在
config/database.php中把数据库类型从'type' => 'mysql'改为'type' => 'pgsql' -
'hostname'填 GaussDB 实例的内网地址（如gaussdb-opengauss-xxxxxx.gaussdb.rds.huaweicloud.com），'port'一般为5432（不是 3306） -
'database'填创建实例时指定的数据库名（默认是postgres，但生产环境建议新建专用库） -
'username'和'password'必须是 GaussDB 创建的用户，且该用户需有对应库的CONNECT和USAGE权限 - 不需要、也不能加
PDO::MYSQL_ATTR_INIT_COMMAND或PDO::ATTR_EMULATE_PREPARES—— 这些是 MySQL 特有参数，PostgreSQL 驱动不识别，写了反而触发警告或忽略
GaussDB(for openGauss) 的密码认证方式必须匹配
华为云 GaussDB(for openGauss) 默认开启 scram-sha-256 密码加密认证，而旧版 PHP（如 7.4 及更早）的 pdo_pgsql 不支持该方式，连接会卡在认证阶段，报错类似：
SQLSTATE[08006] [28000] FATAL: password authentication failed for user "xxx"
即使密码完全正确也会失败。解决办法只有两个：
- 升级 PHP 到 8.0+（推荐）：8.0 起
pdo_pgsql原生支持scram-sha-256 - 降级 GaussDB 认证方式（不推荐）：通过华为云控制台 → 实例 → 参数模板 → 修改
password_encryption为md5，再重启实例（注意：md5 明文传输风险高，仅限测试环境）
另外，如果使用 SSL 连接（华为云强制要求生产环境开启），需在配置中加上：
'options' => 'sslmode=require sslrootcert=/path/to/server-ca.pem'
证书路径必须是绝对路径，且 PHP 进程有读取权限。
迁移时最容易被忽略的 SQL 兼容性断点
即便连接成功，ThinkPHP 自动生成的 SQL 仍可能报错，因为 GaussDB(for openGauss) 对标准 SQL 更严格：
-
GROUP BY必须包含 SELECT 中所有非聚合字段（MySQL 5.7+ 也如此，但 ThinkPHP 某些链式查询会漏写） - 没有
IF NOT EXISTS语法，建表/建索引前得先查是否存在（Db::query("SELECT to_regclass('table_name')")） -
datetime类型不存在，要用timestamp without time zone或timestamptz，ThinkPHP 的auto_write_timestamp需显式指定格式：'format' => 'Y-m-d H:i:s' -
INSERT ... ON DUPLICATE KEY UPDATE不支持，得改用INSERT ... ON CONFLICT DO UPDATE（需自定义 query 或重写 Model 方法）
这些不是配置问题，而是代码层适配点，上线前必须跑通全量业务 SQL。
