jenssegers/mongodb 支持事务但需满足四大前提：MongoDB ≥4.0 且为副本集、PHP驱动启用session支持（libmongoc≥1.17.0）、连接配置含'retryWrites'=>true、模型继承Jenssegers\Mongodb\Eloquent\Model。
直接说结论：jenssegers/mongodb 扩展支持 MongoDB 事务，但必须满足三个硬性前提——MongoDB 服务端 ≥4.0、PHP 驱动启用 session 支持、Laravel 模型继承正确基类；否则 DB::transaction() 或 User::transaction() 调用会静默失败或抛出 Call to a member function beginTransaction() on null。
为什么 DB::transaction() 在 MongoDB 里会报 “beginTransaction() on null”
这不是 Laravel 写错了，而是底层连接实例没返回有效的事务句柄。常见原因有：
- PHP 的
mongodb扩展未启用libmongoc的 session 功能（phpinfo()中检查libmongoc version≥ 1.17.0，且Session support显示enabled） -
config/database.php中 MongoDB 连接配置漏掉'options' => ['retryWrites' => true]—— 这个开关控制是否启用可重试写入和事务会话，缺了它startTransaction()就不会被调用 - 用了
DB::connection('mongodb')但没在连接定义里显式指定'driver' => 'mongodb'，导致 Laravel fallback 到默认 PDO 连接器，返回 null - 模型仍继承
Illuminate\Database\Eloquent\Model，而非Jenssegers\Mongodb\Eloquent\Model，事务上下文无法绑定到模型操作上
如何正确启用 MongoDB 事务（Laravel 8–11 兼容）
事务不是开箱即用的“开关”，它依赖连接层、驱动层、模型层三者对齐。关键步骤如下：
- 确认 MongoDB 服务端版本 ≥ 4.0 且运行在 replica set 模式（单节点 standalone 不支持事务）
- 在
config/database.php的'mongodb'连接中，确保包含：'options' => [ 'retryWrites' => true, 'readPreference' => 'primary', 'ssl' => false, ], - 所有参与事务的模型必须继承
Jenssegers\Mongodb\Eloquent\Model，例如：use Jenssegers\Mongodb\Eloquent\Model; class Order extends Model { protected $collection = 'orders'; } - 事务必须用模型静态方法或
DB::transaction()启动，不能混用原生collection()->insertOne()—— 后者脱离事务上下文
DB::transaction() 和 Model::transaction() 的行为差异
两者都可用，但触发路径和适用场景不同：
立即学习“PHP免费学习笔记（深入）”；
-
DB::transaction()作用于当前 MongoDB 连接，默认使用config('database.default')对应的连接名；若你配了多个 MongoDB 连接（如'analytics','logs'），需显式传参：DB::connection('analytics')->transaction(...) -
User::transaction()是模型静态代理，它会自动绑定到该模型所属连接（由$connection属性或连接配置决定），更适合跨模型协调操作，例如：User::transaction(function () { $user = User::create(['name' => 'Alice']); Profile::create(['user_id' => $user->_id, 'bio' => '...']); }); - 注意：
Model::transaction()不支持嵌套调用（即内部再调Order::transaction()），会抛出Cannot start transaction inside another transaction；如需嵌套，统一用DB::transaction()并手动管理模型连接 - 事务内所有模型操作必须使用同一数据库连接名，跨连接（如 MySQL + MongoDB）无法组成原子事务——MongoDB 事务只限单 replica set 内的集合
Laravel Excel 导入时禁用事务是必须项
如果你在用 maatwebsite/excel 导入数据到 MongoDB，DB::transaction() 会直接崩掉，因为 Excel 默认开启事务 handler，而 jenssegers/mongodb 的 connection 实例不提供 beginTransaction() 方法。
- 必须发布并修改
config/excel.php，把'handler' => 'db'改成'handler' => 'null' - 不要指望
.env或config:clear能绕过——这个配置只读自excel.php文件 - 禁用后导入变成逐行执行，无回滚保障，所以要在
model()方法里加校验：public function model(array $row) { if (empty($row['email']) || !filter_var($row['email'], FILTER_VALIDATE_EMAIL)) { return null; // 跳过非法行，避免脏数据 } return new User($row); } - 如果业务强依赖原子性，建议改用
DB::transaction()包裹批量User::insert()，而不是走 Excel 导入流程
事务不是魔法开关，它依赖服务端能力、驱动支持、配置对齐和模型声明四者全部到位。最容易被忽略的是 replica set 模式和 retryWrites => true 这两个硬条件——缺一不可，否则连 startTransaction() 都不会被调用，更别说回滚了。
