PHP应用中如何为指定工作表禁用Maatwebsite Excel全局事务？

Maatwebsite Excel（Laravel Excel）默认会为导入操作自动包裹全局事务，但完全可以针对特定工作表禁用该默认行为，实现自定义事务管理。

具体实现方法 #

1. 单个工作表导入：直接禁用自动事务 #

在需要自定义事务的导入类中，添加$transactional属性并设置为false，该工作表的导入操作就不会触发库的全局自动事务：

use Maatwebsite\Excel\Concerns\ToModel;
use Illuminate\Support\Facades\DB;

class CustomSheetImport implements ToModel
{
    // 禁用全局自动事务
    public $transactional = false;

    public function model(array $row)
    {
        // 自行编写事务逻辑
        DB::beginTransaction();
        try {
            // 你的数据处理、入库逻辑
            DB::commit();
        } catch (\Exception $e) {
            DB::rollBack();
            throw $e;
        }
    }
}

2. 多工作表导入：按需配置事务开关 #

如果是多工作表导入，每个工作表对应独立的导入类，只需给需要自定义事务的工作表导入类设置$transactional = false，其他工作表仍保持默认自动事务：

use Maatwebsite\Excel\Concerns\WithMultipleSheets;

class MultiSheetImport implements WithMultipleSheets
{
    public function sheets(): array
    {
        return [
            // 保持默认自动事务的工作表
            0 => DefaultTransactionalImport::class,
            // 禁用自动事务、自行管理的工作表
            1 => CustomNonTransactionalImport::class,
        ];
    }
}

3. 验证效果 #

禁用全局事务后，可通过数据库日志或调试工具确认：

• 库不再自动包裹全局事务
• 自定义的DB::beginTransaction()/DB::commit()/DB::rollBack()逻辑正常执行
• 之前出现的DEALLOCATE prepare_statement挂起问题会因事务正确终结而解决

注意事项 #

• 自定义事务要覆盖所有异常场景，避免出现事务未提交/回滚的情况
• 若使用队列执行导入，需确保自定义事务与队列的事务机制兼容，避免嵌套事务冲突

内容的提问来源于stack exchange，提问作者Mike Mouannes