ThinkPHP 原生不支持 GaussDB for Mongo，因协议扩展、TLS 强制认证、IAM/token 认证机制及命令返回结构差异导致 type => 'mongo' 配置失败；唯一稳定方案是弃用 Db 类和模型，直连 mongodb/mongodb 扩展并手动处理 TLS、CA 证书、连接池与 BSON 类型。
ThinkPHP 原生不支持 GaussDB for Mongo（即 GaussDB 的文档型引擎），Db 类和 think\Model 无法直接操作 MongoDB 协议的 GaussDB 实例。强行配置 type => 'mongo' 会报错或静默失败，因为 ThinkPHP 的 mongo 驱动仅适配旧版原生 MongoDB（3.x/4.x），不兼容 GaussDB for Mongo 的协议扩展与认证机制。
为什么 type => 'mongo' 在 GaussDB for Mongo 上跑不通
华为云 GaussDB for Mongo 是基于 MongoDB 协议的增强版，但做了关键改动：
- 强制要求 TLS 1.2+ 加密连接，且需指定 CA 证书路径（原生 ThinkPHP
mongo驱动不支持ssl_ca参数） - 认证方式使用 IAM 或 GaussDB 自定义 token，不支持标准 MongoDB 的 SCRAM-SHA-1/256 用户密码直连
- 部分命令（如
listCollections）返回结构与原生 MongoDB 不一致，导致 ThinkPHP 的集合探测逻辑崩溃 -
connections.mongo.params中传入的选项（如connectTimeoutMS）会被忽略，底层驱动未透传
实际可用的连接方案：绕过 ThinkPHP 抽象层，直连 PHP MongoDB 扩展
必须放弃 Db:: 和模型类，改用原生 mongodb/mongodb Composer 包 + ext-mongodb 扩展。这是目前唯一稳定可行的方式：
- 安装扩展：
pecl install mongodb（PHP 7.4+ 必须启用） - 引入驱动：
composer require mongodb/mongodb - 连接示例（含 TLS 和 IAM 认证适配）：
use MongoDB\Client;
use MongoDB\Driver\Manager;
$uri = 'mongodb://user:password@rm-xxx.gaussdb.huaweicloud.com:8635/admin?ssl=true&tlsCAFile=/path/to/ca-bundle.crt&authMechanism=SCRAM-SHA-256';
$client = new Client($uri, [
'connectTimeoutMS' => 5000,
'socketTimeoutMS' => 30000,
]);
$collection = $client->selectCollection('mydb', 'users');
$result = $collection->find(['status' => 'active'])->toArray();
注意：tlsCAFile 路径必须是绝对路径，相对路径在 CLI 和 FPM 下行为不一致；华为云控制台下载的 CA 证书需解压后指定到 .crt 文件，不能是 zip 包。
立即学习“PHP免费学习笔记（深入）”；
CURD 操作不能套用 ThinkPHP 语法，必须按 MongoDB 原生语义重写
以下常见操作在 GaussDB for Mongo 中的对应写法：
- 插入单条：
$collection->insertOne(['name' => 'alice', 'ts' => new \MongoDB\BSON\UTCDateTime()]) - 批量插入：
$collection->insertMany([['x'=>1], ['x'=>2]])，不支持 ThinkPHP 风格的二维数组自动展开 - 条件查询：
$collection->find(['age' => ['$gt' => 18]])，运算符必须带$前缀，不能写成['age >' => 18] - 更新操作：
$collection->updateOne(['_id' => $id], ['$set' => ['name' => 'bob']])，必须显式用$set等更新操作符 - 删除：
$collection->deleteOne(['status' => 'deleted'])，无where()链式调用
所有 ObjectId 必须用 new \MongoDB\BSON\ObjectId('...') 构造，字符串 ID 直接比较会失败；时间字段推荐统一用 UTCDateTime，避免时区转换错误。
最易被忽略的是连接复用和异常捕获——GaussDB for Mongo 在高并发下连接池耗尽时不会抛出 MongoConnectionException，而是静默超时，必须手动设置 maxPoolSize 并监听 connectionTimeoutMS。不要依赖 ThinkPHP 的数据库调试日志，它对原生 MongoDB 驱动完全不可见。
