ThinkPHP 6.x 不支持 think-mongo，因其已废弃且仅兼容 TP5.1；应直接集成官方 mongodb/mongodb 客户端，通过容器单例管理连接，并注意 MongoDB 查询语法、类型匹配及聚合操作规范。
ThinkPHP 6.x 能不能直接用 think-mongo
不能，官方已明确废弃。TP6 默认不兼容 think-mongo，这个扩展只支持到 TP5.1，且作者早已停止维护。强行安装会触发 Class 'MongoClient' not found 或 DriverManager::create() is deprecated 等错误——本质是它依赖过时的 PHP MongoDB 扩展（mongo 扩展），而现代环境只支持 mongodb 扩展（libmongoc 驱动）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 别搜“think-mongo 安装教程”，那些全是 TP5 时代的遗留内容
- 确认 PHP 已启用
mongodb扩展（运行php -m | grep mongodb） - TP6 正确路径是：绕过 ORM 层，直连官方
mongodb/mongodb客户端库
在 TP6 中手动集成 mongodb/mongodb 客户端
这不是“配置一个扩展”，而是引入标准 Composer 包并封装连接逻辑。TP6 的容器和配置机制足够支撑干净接入，无需魔改框架。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 执行
composer require mongodb/mongodb，确保版本 ≥1.12（适配 PHP 8.0+） - 在
app/common.php或单独服务类里初始化客户端，例如：$client = new \MongoDB\Client('mongodb://127.0.0.1:27017');<br>$collection = $client->selectDatabase('mydb')->selectCollection('user'); - 避免把
$client实例塞进每次请求都 new 一次——应通过 TP6 的bind或singleton注册为容器单例 - 连接字符串中不要硬写
localhost，用127.0.0.1避免 IPv6 解析延迟
TP6 里写 MongoDB 查询，为什么 find() 返回空数组？
常见于照搬 MySQL 语法写条件，比如传入 ['status' => 1] 却没意识到 MongoDB 的查询结构是嵌套文档，且字段名区分大小写、不支持隐式类型转换。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
-
find(['name' => 'Alice'])是对的；但find(['name' => ['like' => '%ice%']])是错的——MongoDB 没有like，要用正则：['name' => ['$regex' => 'ice', '$options' => 'i']] - 数值查询注意类型：存的是
Int32，却用['age' => '25']（字符串）查不到 - 时间字段慎用
date('Y-m-d')，MongoDB 存的是UTC DateTime，应传new \MongoDB\BSON\UTCDateTime(strtotime('2024-01-01') * 1000) - 聚合查询必须用
aggregate()，不是select()——TP6 的 Db 类根本不管 NoSQL
要不要封装个 MongoModel 类来模仿 TP 的模型写法？
可以，但别追求“和 MySQL 模型一模一样”。MongoDB 的 schema-less 特性会让很多 TP 模型方法（如 validate、autoWriteTimestamp）失去意义，强行套用反而增加歧义。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 只封装最常用的：连接、集合选择、
insertOne/updateOne/deleteOne/find/countDocuments - 字段自动填充（如
create_time）用构造函数或插入前手动 set，别依赖 TP 的autoWriteTimestamp - 事务支持需 MongoDB 4.0+ 且副本集部署，
startSession()和withTransaction()必须显式调用，无法隐藏到模型方法里 - 如果项目同时用 MySQL 和 MongoDB，建议把 Mongo 相关操作全收口到
app/service/MongoService.php，别污染 Model 层
真正麻烦的从来不是怎么连上，而是设计阶段没想清楚：这个集合到底需不需要 _id？要不要分片？更新时用 $set 还是整个文档替换？这些决策一旦定错，后期比改代码还难调。
