Laravel如何实现数据库事务回滚_Laravel DB::transaction用法与异常捕获【技巧】

会，但仅限于未被 catch 的异常；Laravel 的 DB::transaction 通过 try...catch 捕获未处理的 Throwable 并自动回滚，若异常被吞掉或发生致命错误则不会回滚。

DB::transaction 会自动回滚吗？

会，但仅限于未被 catch 的异常。Laravel 的 DB::transaction 内部使用了 PHP 的 try...catch，只要回调函数里抛出未被捕获的 Exception 或 Error（包括 Throwable），事务就会自动执行 ROLLBACK 并重新抛出异常。

常见误解是“写了 DB::transaction 就万事大吉”，其实只要在回调里用 try/catch 把异常吞掉，又没手动 DB::rollBack()，事务就悄无声息地提交了。

• ✅ 正确：不捕获异常，或捕获后重新 throw
• ❌ 错误：catch (\Exception $e) { Log::error($e); } —— 事务已提交，日志写了，数据却错了
• ⚠️ 注意：die、exit、PHP 致命错误（如 undefined function）不会触发自动回滚，因为绕过了异常处理机制

如何在事务中手动控制回滚时机？

有时需要根据业务逻辑判断是否回滚，比如部分操作失败但不想终止整个流程，或需记录中间状态。这时不能依赖自动回滚，得显式调用 DB::rollBack()。

关键前提是：必须在 DB::transaction 回调内操作，且不能提前 return 或 throw —— 否则后续代码不执行，rollBack() 就没机会运行。

Video Summarization

一款可以自动将长视频制作成短片的桌面软件

下载

• 用 DB::beginTransaction() + DB::commit()/DB::rollBack() 手动管理更灵活，但要自己确保成对出现
• 若坚持用 DB::transaction，可在回调末尾加条件判断：

  DB::transaction(function () {
      $user = User::create([...]);
      $profile = Profile::create([...]);
  
      if (!$profile->is_valid) {
          DB::rollBack(); // ⚠️ 这行无效！DB::transaction 不允许手动 rollBack
          throw new \Exception('Profile invalid');
      }
  });

• 真正可行的手动控制方式是改用 DB::beginTransaction()：

  DB::beginTransaction();
  try {
      $user = User::create([...]);
      $profile = Profile::create([...]);
  
      if (!$profile->is_valid) {
          DB::rollBack();
          return response()->json(['error' => 'Profile invalid'], 400);
      }
  
      DB::commit();
      return response()->json(['success' => true]);
  } catch (\Exception $e) {
      DB::rollBack();
      throw $e;
  }

嵌套事务在 Laravel 中是否生效？

Laravel 的 DB::transaction 不支持真正的嵌套事务。MySQL 等数据库本身也不支持（除非用保存点），多次调用只是增加嵌套层级计数，commit 和 rollBack 都只作用于最外层事务。

如果你在事务中又调用了另一个也带 DB::transaction 的方法，里面的异常仍会向上冒泡到最外层，触发整体回滚 —— 看似“嵌套”，实则是扁平传播。

• ✅ 安全做法：把所有相关操作写进同一个 DB::transaction 回调里
• ❌ 危险做法：A 方法开启事务，调用 B 方法（B 也开启事务），B 出错只 rollback 自己 —— 实际上 B 的 rollback 会被忽略，A 仍会 commit
• ? 替代方案：用 DB::transaction + 保存点（savepoint），需手动执行 DB::statement('SAVEPOINT sp1') 和 DB::statement('ROLLBACK TO sp1')，但跨数据库兼容性差

事务中模型事件和队列任务的陷阱

模型的 creating、saving 等事件在事务内触发，但如果你在事件里分发了队列任务（如 dispatch(new SendWelcomeEmail($user))），这些任务会在事务提交后才执行 —— 这是 Laravel 队列的默认行为（after_commit）。但如果队列驱动是 sync，任务会立刻执行，此时事务可能还没提交，导致查不到刚插入的数据。

• ✅ 推荐：统一用 database 或 redis 驱动，并确认 QUEUE_CONNECTION 配置正确
• ⚠️ 高风险场景：事务中创建用户并立即 dispatch sync 队列发短信，短信服务查库找不到该用户 —— 因为 INSERT 还没 commit
• ? 补救：强制等待事务结束再 dispatch：

  DB::transaction(function () {
      $user = User::create([...]);
      
      // 延迟到 commit 后执行
      dispatch(new SendWelcomeEmail($user))->afterCommit();
  });