架构与系统设计 / 系统课时

用 Saga 编排补偿流程

用 Saga 编排补偿流程

Saga 适合那些无法放进单个数据库事务、却又需要跨多个服务完成的长流程。做法不是把所有服务锁在一起,而是把流程拆成一组可独立提交的本地事务,并为已经成功的步骤准备反向补偿;当后续步骤失败时,编排器按已执行顺序的逆序恢复业务状态,必要时转入人工处理。

学习目标

  • 能把跨服务长事务拆成正向动作、补偿动作和不可补偿节点。
  • 能设计编排器的失败分支、幂等控制和补偿顺序。
  • 能识别需要人工兜底的补偿失败与不可逆外部操作。

把长事务拆成可补偿步骤

假设下单流程依次执行“预留库存、扣款、创建发货单”。每一步都只提交本服务自己的事务,不等待其他服务参与同一数据库提交。与每个正向动作配对的补偿分别是“释放库存、退款、取消发货单”。

补偿不是数据库回滚。退款可能产生一笔新的资金流水,释放库存也可能因为其他订单已占用而需要再次校验。因此,设计 Saga 时要把补偿视为新的业务事务,并明确它在重复执行、超时重试和部分成功时的语义。

编排器如何处理失败

编排式 Saga 由一个明确的编排器保存流程状态并决定下一步。它需要知道哪些步骤已经提交成功,因为只有这些步骤才允许进入补偿;补偿必须按业务依赖的逆序执行,避免先释放前置资源,却留下后置资源仍然有效。

Saga 编排与补偿时序

编排器本身也会失败,所以状态不能只保存在进程内存。生产实现通常把 Saga ID、当前步骤、步骤执行结果、补偿状态和重试次数持久化;每个服务都用 Saga ID 或业务请求 ID 做幂等键,确保“消息至少投递一次”不会变成“业务至少执行两次”。

写一个可执行的 Saga

下面的最小示例故意让“创建发货单”失败。程序会记录已完成步骤,并按逆序执行退款和库存释放,演示补偿链的核心控制逻辑。

python
state = {
    'inventory_reserved': False,
    'payment_charged': False,
}

def reserve_inventory():
    state['inventory_reserved'] = True

def release_inventory():
    state['inventory_reserved'] = False

def charge_payment():
    state['payment_charged'] = True

def refund_payment():
    state['payment_charged'] = False

def create_shipment():
    raise RuntimeError('shipping service unavailable')

steps = [
    ('reserve_inventory', reserve_inventory, release_inventory),
    ('charge_payment', charge_payment, refund_payment),
    ('create_shipment', create_shipment, None),
]

completed = []

try:
    for name, action, compensation in steps:
        action()
        completed.append((name, compensation))
        print(f'DONE {name}')
except RuntimeError as exc:
    print(f'FAILED {exc}')
    for name, compensation in reversed(completed):
        if compensation is not None:
            compensation()
            print(f'COMPENSATED {name}')

print(state)

预期输出

text
DONE reserve_inventory
DONE charge_payment
FAILED shipping service unavailable
COMPENSATED charge_payment
COMPENSATED reserve_inventory
{'inventory_reserved': False, 'payment_charged': False}

这个示例只演示控制流,真实系统还必须把“动作已成功”和“补偿已成功”持久化后再推进状态,否则编排器在两个网络调用之间崩溃时,会失去恢复依据。

设计生产级补偿边界

不是所有动作都应该立即执行。短信、邮件通常无需补偿;而“向不可撤销的外部系统提交最终指令”更适合作为后置的不可逆步骤,只有前面所有可补偿步骤稳定后才触发。这个位置常被称为业务上的提交点或 pivot。

补偿接口要满足幂等,例如重复退款请求不能重复打款,重复释放库存不能把库存加两次。对于“补偿本身失败”的情况,不要无限同步重试;应记录失败原因,进入有退避的异步重试,并在超过阈值后转入人工处理队列,同时保留完整审计轨迹。

当某个步骤根本无法自动补偿,例如资金已经通过人工渠道结算、票据已经线下生效,就要在设计阶段明确人工兜底动作、负责人、SLA 和判定依据。Saga 的可靠性来自“每条失败路径都有下一步”,而不是假设补偿永远成功。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Saga 编排补偿流程

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通