laravel原生不支持mongodb，因db门面依赖pdo关系型驱动，而mongodb是nosql，无sql引擎、事务和join；直接配置mongodb驱动会报“unsupported driver [mongodb]”错误；必须使用jenssegers/mongodb扩展，它重写eloquent与查询构建器，适配文档结构与查询语法。
Laravel 原生不支持 MongoDB，必须通过第三方扩展实现；直接装 mongodb/mongodb 扩展或用 illuminate/database 的 Eloquent 是行不通的。
为什么不能直接用 Laravel 的 DB 门面操作 MongoDB
Laravel 的 DB 门面底层依赖 PDO，而 MongoDB 是 NoSQL，没有 SQL 查询引擎，也不支持事务、JOIN、预处理语句等关系型特性。即使你装了 PHP 的 mongodb 扩展（即 ext-mongodb），DB::table('users')->get() 这类调用仍会报错：Unsupported driver [mongodb]。
-
DB门面只认mysql、pgsql、sqlite等 PDO 驱动 -
eloquent模型默认绑定DB，无法自动适配 MongoDB 的文档结构和查询语法 - 强行修改配置加
mongodb到database.php的connections里，启动就会抛出驱动未注册异常
推荐方案：使用 jenssegers/mongodb 扩展
这是目前最成熟、Laravel 兼容性最好的 MongoDB 扩展，它重写了 Eloquent 的查询构建器和模型逻辑，让 User::where('status', 'active')->get() 这类写法能真正跑起来。
- 要求 PHP >= 7.4，Laravel >= 8.x（Laravel 10/11 也支持，但需确认扩展版本）
- 必须先安装官方 PHP 驱动：
pecl install mongodb，并在php.ini中启用extension=mongodb - 然后执行：
composer require jenssegers/mongodb - 发布配置：
php artisan vendor:publish --provider="Jenssegers\Mongodb\MongodbServiceProvider"，生成config/database.php中的mongodb连接配置 - 在
config/database.php的connections下添加连接，注意host、port、database和认证参数（如username/password）要填对
定义 MongoDB 模型时的关键差异
继承 Jenssegers\Mongodb\Eloquent\Model 而不是 Illuminate\Database\Eloquent\Model，否则查询会走错驱动。
- 主键默认是
_id（ObjectId 类型），不是id；若想用自增整数 ID，得手动设置$incrementing = true并禁用_id自动生成，但不推荐 -
$fillable和$casts正常可用，但$dates已废弃，改用$casts = ['created_at' => 'datetime'] - 关联关系（
hasOne、hasMany）支持有限：不支持跨数据库关联，嵌入式子文档用embedded更自然，而非外键式关联 - 聚合查询不能用
DB::collection()链式调用，得用原生方法：User::raw(function ($collection) { return $collection->aggregate([...]); });
容易被忽略的连接与调试细节
MongoDB 连接字符串格式和错误反馈非常隐蔽——连不上时往往只报 Connection refused 或静默失败，而不是明确提示认证失败或数据库不存在。
- 连接字符串必须带
?authSource=admin（如果用户建在 admin 库），否则即使密码正确也会认证失败 - 使用副本集时，
host要写成数组形式：['rs1.example.com:27017', 'rs2.example.com:27017']，并设options.replicaSet - 开启 debug 后，Laravel 日志不会记录 MongoDB 查询语句，需单独监听：
\MongoDB\Driver\Monitoring\CommandStartedEvent或用MongoDB\BSON\toJSON()手动打印 - 生产环境务必关闭
debug模式下的慢查询日志，MongoDB 的explain()在高并发下有显著性能开销
