Django 中 transaction.atomic() 的事務(wù)行為進行系統(tǒng)性總結(jié)，重點說明：哪些異常會觸發(fā)自動回滾、哪些情況不會、為何產(chǎn)生差異，以及如何正確編寫可控的事務(wù)邏輯。

1. transaction.atomic() 的基本行為

transaction.atomic() 會在進入時創(chuàng)建一個 數(shù)據(jù)庫保存點（savepoint）。
代碼塊退出時根據(jù)執(zhí)行結(jié)果決定回滾或提交：

• 若出現(xiàn) 未捕獲的異常：自動回滾到保存點，并繼續(xù)拋出該異常。
• 若代碼執(zhí)行正常結(jié)束：提交保存點。

核心原則：是否回滾取決于是否有異常向外拋出。

2. 會觸發(fā)自動回滾的情況

2.1 未捕獲的 Python 異常

只要異常沒有在 atomic 塊內(nèi)被捕獲，都會觸發(fā)回滾，包括：

• ZeroDivisionError
• ValueError
• TypeError
• KeyError
• IndexError
• AssertionError
• 自定義異常
• raise Exception("...")

示例：

with transaction.atomic():
    obj = Model.objects.create(...)
    raise Exception("abort transaction")  # 未捕獲 → 自動回滾

2.2 未捕獲的 Django ORM / 數(shù)據(jù)庫異常

數(shù)據(jù)庫相關(guān)異常未被捕獲時，也會觸發(fā)自動回滾，包括：

• IntegrityError（唯一約束、外鍵約束）
• DataError（無效數(shù)據(jù)）
• OperationalError（死鎖、鎖超時）
• ProgrammingError（SQL 錯誤）
• DatabaseError
• InterfaceError

示例：

with transaction.atomic():
    Model.objects.create(id=1)
    Model.objects.create(id=1)  # IntegrityError → 自動回滾

2.3 DRF 驗證錯誤（raise_exception=True）

serializer.is_valid(raise_exception=True)

該語句拋出的 ValidationError 未被捕獲 → 自動回滾。

3. 不會自動回滾的情況

3.1 異常被捕獲并吞掉

只要異常被捕獲，沒有繼續(xù)向外拋出，Django 會視為“執(zhí)行成功”，不會回滾。

with transaction.atomic():
    try:
        raise Exception("error")
    except Exception:
        pass  # 異常被吞掉 → 不回滾

若需要強制回滾，必須手動調(diào)用：

transaction.set_rollback(True)

3.2 沒有異常但提前 return

業(yè)務(wù)判斷不屬于錯誤，不會自動回滾。

with transaction.atomic():
    if invalid:
        return Response({"error": ...})  # 不回滾

3.3 DRF 驗證錯誤未 raise

serializer.is_valid(raise_exception=False)
if serializer.errors:
    return Response(serializer.errors)  # 不回滾

只有拋出異常才會回滾。

3.4 數(shù)據(jù)庫層無異常但邏輯錯誤

例如外鍵檢查關(guān)閉、不符合約束但 MySQL 未拋錯，此類不會產(chǎn)生自動回滾。

3.5 使用 atomic(savepoint=False) 并在內(nèi)部捕獲異常

with transaction.atomic(savepoint=False):
    try:
        raise Exception()
    except:
        pass

內(nèi)部異常被捕獲 → 無異常向上拋出 → 不會回滾。

4. raise Exception(‘xxx’) 是否回滾？

答案：會回滾，只要未被捕獲。

raise Exception('xxx') 會觸發(fā) Python 異常，atomic 在退出時檢測到異常 → 自動回滾保存點。

示例：

with transaction.atomic():
    raise Exception("abort")  # 自動回滾

若被捕獲，則不會回滾：

with transaction.atomic():
    try:
        raise Exception("abort")
    except Exception:
        pass  # 無異常向上拋出 → 不回滾

5. 總結(jié)：事務(wù)回滾的唯一決定因素

Django 中事務(wù)是否回滾，唯一決定因素：

是否有異常從 atomic 塊中冒出。

可以總結(jié)為：

• 未捕獲異常 → 自動回滾
• 捕獲異常 → 不自動回滾
• 沒有異常 → 正常提交
• DRF raise_exception=True → 會回滾
• return 并非錯誤 → 不回滾

6. 推薦的事務(wù)編寫模式（最佳實踐）

from django.db import transaction

def perform_action():
    try:
        with transaction.atomic():
            # 業(yè)務(wù)邏輯
            do_something()

    except Exception as e:
        # atomic 已自動回滾
        handle_error(e)
        raise

如果希望在捕獲異常后仍然回滾：

with transaction.atomic():
    try:
        do_something()
    except Exception:
        transaction.set_rollback(True)  # 手動回滾
        raise

到此這篇關(guān)于Django MySQL 事務(wù)機制與回滾行為的使用說明的文章就介紹到這了,更多相關(guān)Django MySQL 事務(wù)機制與回滾行為內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論