17370845950

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() 时触发致命错误。

✅ 正确解决步骤如下：

1. 发布 Excel 配置文件（若尚未发布）：

   php artisan vendor:publish --provider="Maatwebsite\Excel\ExcelServiceProvider" --tag=config

2. 修改 config/excel.php 中的事务配置：
   找到 transactions 数组，将 handler 明确设为 'null'：

   'transactions' => [
       'handler' => 'null', // 关键：禁用事务，避免调用不存在的 beginTransaction()
   ],

3. 清除并重载配置缓存（确保生效）：

   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 支持关系型语义。