ThinkPHP6不支持KingbaseES是因框架无预置Kingbase驱动类，仅改type为kingbase会报Class not found；需手动扩展Connector（改kdb协议、端口）和Builder（适配table_msg()等），并安装pdo_kdb扩展。
ThinkPHP6 无法原生支持 KingbaseES，必须手动扩展连接器和 Builder 类，否则模型查询（如 User::find()）会报错或返回空，仅 Db::query() 可用。
为什么直接改 type 为 kingbase 不行
ThinkPHP6 的 ORM 驱动加载机制依赖 type 值匹配预置类名（如 mysql → Mysql 类），而框架源码中根本不存在 Kingbase 类。即使你在 database.php 里写 'type' => 'kingbase'，运行时会抛出 Class "think\db\connector\Kingbase" not found。这不是配置问题，是驱动缺失。
常见错误现象：
- 启动时报
Class "think\db\connector\Kingbase" not found -
Db::table('user')->select()正常，但User::all()报 SQL 解析异常或字段为空 - 迁移命令
php think migrate:run失败，提示不支持的 DDL 语法
必须复制并修改两个核心文件：Connector 和 Builder
KingbaseES 基于 PostgreSQL，但不完全兼容；它用 kdb: 协议前缀，且部分系统视图（如字段元数据查询）与 pg 不同。因此不能只改 DSN，Builder 中的 SQL 构造逻辑也得适配。
立即学习“PHP免费学习笔记（深入）”；
实操步骤：
- 进入
vendor/topthink/think-orm/src/db/connector/，复制Pgsql.php为Kingbase.php，修改类名为class Kingbase extends PDOConnection - 重写
parseDsn()方法，把pgsql:换成kdb:，并显式拼接port（KingbaseES 默认端口是54321，不是5432） - 进入
vendor/topthink/think-orm/src/db/builder/，同样复制Pgsql.php为Kingbase.php，类名同步修改 - 重点修改
getFields()方法：原 pg 的pg_class+pg_attribute查询在 KingbaseES 中需替换为table_msg()函数调用（例如：SELECT * FROM table_msg('user');），否则Model初始化字段缓存失败 - 注释掉 Pgsql Builder 中依赖
nextval(判断自增的逻辑（KingbaseES 的序列语法虽类似，但table_msg()不返回extra字段）
database.php 配置的关键参数不能省
配置不是“照抄 pg 示例就行”，KingbaseES 对连接参数敏感，尤其在政务高可用场景下：
-
'type' => 'kingbase'必须与你新建的类名严格一致（大小写敏感） -
'hostport' => '54321'必须显式指定，不填会 fallback 到 5432，连不上 -
'charset' => 'utf8'不能写utf8mb4—— KingbaseES V8/V9 尚未完整支持 utf8mb4，写错会导致中文乱码或插入截断 -
'fields_strict' => false建议关闭，避免因字段类型推导差异导致查询中断（例如numericvsdecimal） -
'break_reconnect' => true推荐开启，政务系统要求连接容错，断连后自动重试比抛异常更稳妥
pdo_kdb 扩展是硬性前提，不是可选项
PHP 层没有 pdo_kdb 扩展，new PDO('kdb:host=...') 会直接报 could not find driver。这和 MySQL/PgSQL 的 pdo_mysql/pdo_pgsql 是同一层级的底层依赖。
注意点：
- 官方只提供 PHP 7.x 的二进制扩展（.so/.dll），PHP 8.x 需自行编译或使用社区版（如网盘提取码
zj5p提供的版本） -
php -m | grep kdb或print_r(PDO::getAvailableDrivers())必须看到kdb，否则后续所有操作都无效 - Nginx/Apache 的 PHP 运行用户（如
www）需有权限读取扩展文件，SELinux 开启时可能需额外赋权 - 不要试图用
pdo_pgsql“凑合”——协议层不识别kdb:，连接直接拒绝
真正容易被忽略的是 table_msg() 函数的权限问题：KingbaseES 要求执行该函数的用户必须有 SELECT 权限在 sys_tables 等系统表上，否则 getFields() 返回空数组，模型连字段名都拿不到，静默失败。
