laravel excel 在使用 mongodb 作为数据库时会因不支持事务而抛出 “call to a member function begintransaction() on NULL” 错误；根本解决方式是禁用 excel 的事务处理机制，并正确配置其 `transactions.handler` 为 `null`。
Laravel Excel 默认启用数据库事务（handler => ‘db’），在导入过程中自动调用 beginTransaction()、commit() 或 rollback()。然而，MongoDB 官方驱动（如 jenssegers/mongodb）完全不支持 laravel 的 DB 事务接口——其 connection() 实例返回 null，导致调用 beginTransaction() 时触发致命错误。
✅ 正确解决步骤如下：
-
发布 Excel 配置文件（若尚未发布）：
php artisan vendor:publish --provider="MaatwebsiteExcelExcelServiceProvider" --tag=config -
修改 config/excel.php 中的事务配置：
找到 transactions 数组，将 handler 明确设为 ‘null’：'transactions' => [ 'handler' => 'null', // 关键：禁用事务，避免调用不存在的 beginTransaction() ], -
清除并重载配置缓存（确保生效）：
php artisan config:clear php artisan config:cache
⚠️ 注意事项：
- 不要仅靠 php artisan config:clear 或修改 .env 解决——该配置位于 excel.php，必须显式发布并修改；
- 即使项目中未使用 mysql/postgresql，只要 handler 仍为 ‘db’，Excel 就会尝试调用 Eloquent/DB facade 的事务方法，而 mongodb 连接不提供该能力；
- handler => ‘null’ 并非“忽略错误”，而是主动跳过事务逻辑，完全适配无事务型数据库（如 MongoDB、sqlite in-memory 等）；
- 导入过程将变为“逐行执行 + 无回滚保障”，因此建议在 model() 方法中增加数据校验（如 isset($row[‘username’])）、异常捕获或预验证逻辑，以提升健壮性。
示例增强版 UsersImport（含基础容错）：
use IlluminateSupportFacadesLog; class UsersImport implements ToModel, WithHeadingRow, WithValidation { public function model(array $row) { // 跳过空行或关键字段缺失行 if (empty($row['username']) || empty($row['password'])) { Log::warning('Skipped invalid row in Excel import', $row); return null; } return new User([ 'descrizione' => $row['descrizione'] ?? '', 'username' => $row['username'], 'password' => Hash::make($row['password']), 'meccanografico' => $row['meccanografico'] ?? null, 'role_id' => (int) ($row['role_id'] ?? 1), ]); } public function rules(): array { return [ 'username' => 'required|string|unique:users,username', 'password' => 'required|string|min:6', ]; } }至此，导入功能即可在 MongoDB 环境下稳定运行。核心原则始终不变：让工具适配存储层特性，而非强行要求 nosql 支持关系型语义。