Django 中的数据库事务如何工作？

Question

Django 中的数据库事务如何工作？

Accepted Answer

**数据库事务** 将多个操作分组，使它们要么 **全部成功，要么全部失败**（原子性）— 防止部分的、不一致的更新。Django 提供 `transaction.atomic` 来将操作包装在一个事务中，确保多步骤操作的数据完整性。

## 事务解决的问题

```python
# ❌ WITHOUT a transaction — partial failure leaves inconsistent data
def transfer_money(from_account, to_account, amount):
    from_account.balance -= amount
    from_account.save()                  # ✓ succeeds
    # ...if the server crashes HERE, money vanished from one account...
    to_account.balance += amount
    to_account.save()                    # ✗ never runs → money LOST!
```

如果没有事务，当第二个操作失败时，第一个操作已经提交 — 留下数据库处于破损、不一致的状态（钱被扣除但未被转账）。

## transaction.atomic — 全有或全无

```python
from django.db import transaction

# as a context manager
def transfer_money(from_account, to_account, amount):
    with transaction.atomic():           # everything inside is ONE transaction
        from_account.balance -= amount
        from_account.save()
        to_account.balance += amount
        to_account.save()
    # if ANY operation raises an exception, the WHOLE block is ROLLED BACK
    # → either both saves happen, or neither does (atomicity)
```

```python
# or as a decorator on a whole function/view
@transaction.atomic
def create_order(request):
    order = Order.objects.create(...)
    for item in items:
        OrderItem.objects.create(order=order, ...)
    # all-or-nothing: a failure anywhere rolls back the entire order creation
```

在 `atomic()` 中，如果任何操作引发异常，Django **回滚** 块中的每项更改 — 因此数据库永远不会处于半更新状态。成功时，所有更改一起提交。

## 嵌套 atomic 块（保存点）

```python
with transaction.atomic():               # outer transaction
    do_something()
    try:
        with transaction.atomic():       # inner = a SAVEPOINT
            risky_operation()
    except Exception:
        pass                              # inner rolls back to the savepoint; outer continues
```

嵌套的 `atomic` 块使用保存点 — 内部块可以独立回滚，而不会中止整个外部事务。

## 重要细节

```text
✓ Catch exceptions OUTSIDE the atomic block (catching inside can break rollback handling)
✓ select_for_update() locks rows within a transaction (prevent race conditions on updates)
    with transaction.atomic():
        account = Account.objects.select_for_update().get(pk=id)  # row locked until commit
✓ ATOMIC_REQUESTS setting wraps EVERY request in a transaction (per-database)
✓ Keep transactions SHORT — long transactions hold locks, hurting concurrency
```

## 为什么这很重要

数据库事务对于 **数据完整性** 至关重要，特别是当操作涉及多个必须作为一个整体成功或失败的相关数据库更改时 — 理解 `transaction.atomic` 是构建正确、可靠应用程序的重要知识。

事务解决的核心问题是 **部分失败**：没有原子性的情况下，如果多步操作中途失败（崩溃、异常、约束冲突），数据库会处于不一致状态 — 经典的转账示例（从一个账户扣除但未转入另一个）说明了这如何破坏数据并可能导致严重后果。`transaction.atomic` 提供 **全有或全无** 的保证（任何失败时回滚整个块），这对于跨多个写操作的任何操作都是必要的 — 创建包含行项目的订单、转账、更新相关记录 — 以维护一致的数据库。

理解如何使用 atomic 块（作为上下文管理器或装饰器）、带有保存点的嵌套事务以及重要细节 — 在块 *外* 捕获异常、使用 **`select_for_update()`** 锁定行以防止并发更新中的竞态条件、保持事务简短以避免持有锁 — 是构建健壮应用程序的实践知识。

数据一致性是可靠系统的基本要求，事务是确保多步骤数据库操作中一致性的机制，这是一个重要话题，它区分了编写正确、保持完整性代码的开发人员和那些应用程序在故障条件或并发访问下可能悄悄破坏数据的开发人员 — 这是处理重要相关数据更改的任何应用程序中的常见关切。