php mongodb扩展必须正确加载，ci 3.x需用codeigniter-mongodb-library库，配置uri、类名、文件路径须严格匹配，开启db_debug排查静默失败，aggregate参数须为带$前缀的二维数组。
确认 PHP 的 mongodb 扩展已正确加载
不装对扩展，后面所有配置都白搭。CI 连不上 MongoDB，80% 是卡在这步。
先运行 php -m | grep mongodb，看输出里有没有 mongodb（注意不是 mongo，那是旧版废弃扩展）。没有就说明没装成功。
- PHP 7.0+ 必须用官方
mongodb扩展（PECL 包名也是mongodb），mongo扩展在 PHP 7.1+ 已彻底移除 - Windows 下确认
php_mongodb.dll放在ext/目录，且php.ini里写的是extension=php_mongodb.dll（不是extension=mongodb） - Linux/macOS 编译安装后，检查
extension=mongodb.so是否在php.ini中启用，且路径无拼写错误 - 改完
php.ini一定要重启 Web 服务（Apache/Nginx + PHP-FPM），仅重启 Apache 不等于重启 PHP
如果 php -m 有但 CI 仍报 Class 'MongoDB\Driver\Manager' not found，大概率是 CLI 和 Web 使用了不同 php.ini —— 用 phpinfo() 页面确认 Web 环境实际加载的配置文件路径。
用官方推荐的 mongo_db 库而非直接 new Client
CI 3.x 没有原生 MongoDB 支持，必须靠第三方库桥接。别自己封装 MongoDB\Client，容易绕进连接复用、错误处理、配置隔离这些坑里。
用社区维护较久、CI 3.4 兼容性验证过的 codeigniter-mongodb-library（GitHub 上 star 数千的那个）最稳。
- 下载后把
application/config/mongo_db.php放到项目对应路径，**不要改文件名**，CI 加载机制依赖这个命名 -
application/libraries/Mongo_db.php必须首字母大写，且类名是Mongo_db（下划线），否则自动加载失败 - 配置项里
['hostname']填完整 URI 更可靠，比如mongodb://user:pass@127.0.0.1:27017，比拆成 host/port/user/password 更少出错 - 如果连远程 MongoDB（如 Atlas），务必开启 TLS：在 URI 后加
?tls=true&tlsAllowInvalidCertificates=true（测试环境），生产环境用真实 CA
加载时用 $this->load->library('mongo_db', ['activate' => 'default']);，参数数组里的 activate 必须和 config 文件中配置组键名一致，默认是 default。
避免 $this->mongo_db->get() 返回空数组却无报错
这是最常被忽略的静默失败：查询语法没错，也没抛异常，但 get() 就是返回空数组，查日志也看不到问题。
根本原因通常是连接未真正建立，或数据库/集合名拼写错误，而库默认关闭了连接异常提示。
- 打开
application/config/mongo_db.php中的['db_debug'] = TRUE，它会让底层驱动抛出原始连接错误（比如认证失败、DNS 解析失败） - 若仍无声无息，在配置里加
['mongo_supress_connect_error'] = FALSE（部分老版本库支持），强制暴露连接层报错 -
get('users')中的users是 collection 名，不是数据库名；数据库名由配置里的['database']决定，别混淆 - 执行前加一句
var_dump($this->mongo_db->db);，如果输出null，说明初始化失败，99% 是配置路径、类名或扩展没到位
聚合操作（aggregate）必须传二维数组，不能直接传 pipeline 字符串
想用 $sum、$group 等高级功能？mongo_db->aggregate() 接口对参数格式很敏感，错一个括号就返回空或报致命错误。
正确写法是把整个 pipeline 当作 PHP 关联数组传入，每一步是一个子数组：
$pipeline = [
['$match' => ['status' => 'active']],
['$group' => ['_id' => '$category', 'total' => ['$sum' => '$amount']]]
];
$result = $this->mongo_db->aggregate('orders', $pipeline);
- 每个 stage（如
$match、$group）必须是独立数组元素，不能合并成一个大数组 - key 名必须带
$前缀（'$sum'，不是'sum'），MongoDB 驱动不识别无前缀写法 - 字段引用（如
'$amount'）也要带$，否则当成字面量字符串处理 - 如果报
Call to undefined method Mongo_db::aggregate()，说明你用的库版本太老，需升级到支持 aggregate 的分支（GitHub 上搜 “ci-mongodb-aggregate”）
复杂聚合建议先在 MongoDB Shell 或 Compass 里调通 pipeline，再原样转成 PHP 数组结构 —— 别在 PHP 里边试边猜。
