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="Maatwebsite\Excel\ExcelServiceProvider" --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 Illuminate\Support\Facades\Log;
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 支持关系型语义。
