ThinkPHP5 无法兼容新版 MongoDB 驱动，必须弃用 think-mongo 扩展，改用原生 MongoDB\Driver\Manager 直连，并手动处理 BSON 类型转换与独立配置。
think-mongo 扩展在 ThinkPHP5 中已明确不兼容高版本 MongoDB PHP 驱动（如 1.10+），且官方早已停止维护。直接按旧文档配 'type' => '\think\mongo\Connection' 或 'type' => 'thinkmongoConnection'，90% 情况下会报 Class not found 或 DriverException —— 根子不在配置，而在底层驱动断层。
确认 PHP mongodb 扩展是否真正可用
很多问题卡在这一步，但错误提示却藏在日志里，不是报“找不到类”，而是报 Uncaught Error: Class 'MongoDB\Driver\Manager' not found 或更隐蔽的 Invalid argument supplied for foreach()。
- 必须用
php -m | grep mongodb（命令行）和phpinfo()（Web 环境）双验证，只看页面有“mongodb”模块不等于能用——要确认版本 ≥ 1.7（TP5 兼容底线） - Windows 下若用
php_mongodb.dll，务必匹配 PHP 的线程安全（TS/NTS）和架构（x86/x64）；错一个，extension=php_mongodb.dll加了也白加，php -v启动就报错 - Linux 下用
pecl install mongodb后，检查php.ini中是否写成了extension=mongodb.so（不是extension=mongodb），少个.so就静默失败
不要用 topthink/think-mongo=1.*
这个包依赖过时的 ext-mongo（已废弃），与当前 ext-mongodb 完全不兼容。Composer 安装成功 ≠ 能运行 —— 它只是把一堆无法实例化的类扔进 vendor。
- 删掉
composer require topthink/think-mongo安装的任何内容，清空vendor/topthink/think-mongo - 改用原生驱动直连：不需要额外扩展包，
new MongoDB\Driver\Manager('mongodb://127.0.0.1:27017')就是唯一可靠入口 - 如果非要用 ThinkPHP 的 Db 类封装，只能自己写轻量适配器，继承
\think\db\Connection并重写initConnect()，把Manager实例挂进去 —— 但要注意：TP5 的查询构造器（where()、order()）对 BSON 类型无感知，where('status', 'active')可以，where('created_at', ['gt' => new \MongoDB\BSON\UTCDateTime()])必须手动转，否则丢字段
多库共存时，MongoDB 必须走独立连接配置
TP5 不支持在 database.php 里混写 MySQL 和 MongoDB 配置。试图把 'type' => 'mongo' 塞进默认数据库配置，会导致 Db::name() 初始化失败，因为核心 Connection 类根本不认识这个 type。
立即学习“PHP免费学习笔记（深入）”；
- 把 MongoDB 连接信息单独提进
config/mongo.php（非 database.php），内容只保留：['uri' => 'mongodb://127.0.0.1:27017', 'options' => ['connectTimeoutMS' => 500]] - 使用时显式 new：
$manager = new \MongoDB\Driver\Manager(config('mongo.uri'), config('mongo.options'))，再通过$manager->executeCommand('mydb', new \MongoDB\Driver\Command([...]))发命令 - 若坚持用
Db::connect()，需在config/database.php里加一个键如'mongo_db'，但 value 必须是完整连接数组（含'type'、'hostname'等），且该 type 对应的类必须真实存在并可被自动加载 ——think-mongo包做不到这点
查询时最容易漏掉的 BSON 类型转换
MongoDB 不接受 PHP 原生数组当条件，也不认时间戳整数为日期。直接写 where('updated_at', time())，查出来永远空。
-
DateTime→\MongoDB\BSON\UTCDateTime：new \MongoDB\BSON\UTCDateTime(strtotime('2025-01-01') * 1000) - 正则 →
\MongoDB\BSON\Regex：new \MongoDB\BSON\Regex('keyword', 'i')，不能传字符串 - ObjectId →
\MongoDB\BSON\ObjectId：new \MongoDB\BSON\ObjectId($id)，尤其查_id时，字符串 ID 必须转，否则类型不匹配 - 数组操作符（
$in、$regex）必须用全小写键名，TP5 的 where() 会自动转成大写或加引号，导致命令无效
真正跑通 TP5 + MongoDB，靠的不是配对某个扩展名，而是绕过框架抽象层，直面 Driver 层的约束。所有“自动映射”“查询构造器兼容”都是幻觉 —— MongoDB 的文档结构和查询语义，和 SQL 天然不兼容。最稳的路径，是把 Manager 当作连接池管理器，用 Command 或 Query 写明每个请求的数据库、集合、命令字，其余交给 BSON。
