架构与系统设计 / 系统课时
用编排式 Saga 控制流程
用编排式 Saga 控制流程
编排式 Saga 适合步骤多、分支多且需要统一恢复策略的跨服务流程。核心不是让协调器替所有服务做业务,而是让它持有流程状态,按顺序发送命令,并在失败时触发对应补偿。本课以订单、库存和支付为例搭出一条可恢复的编排链路。
学习目标
- 划分 Saga 协调器与领域服务各自负责的逻辑。
- 为正常步骤、失败分支和补偿动作建立明确状态。
- 用幂等命令与持久化进度保证流程可重试、可恢复。
协调器只负责流程决策
编排式 Saga 中,协调器知道“下一步做什么”,领域服务只负责“这一步业务能否完成”。例如协调器可以要求库存服务预留商品,但库存是否足够、如何锁定库存仍由库存服务内部规则决定。
典型顺序是:创建待处理订单,预留库存,扣款,最后确认订单。任何一步失败,协调器根据已经成功的步骤倒序执行补偿。这样正常路径和恢复路径都集中在同一流程模型中,便于观察和测试。

把每一步和补偿成对设计
为每个正向动作预先定义补偿,比“失败后再想怎么办”可靠。可以把流程看成一组有顺序的动作:CreateOrder 对应 CancelOrder,ReserveInventory 对应 ReleaseInventory,ChargePayment 对应 RefundPayment。
补偿只对已经成功的步骤执行,并且通常按相反顺序进行。支付尚未成功就不应退款,库存尚未预留也不应释放。协调器因此必须记录每一步的完成状态,而不能只保存一个粗粒度的“处理中”。
用可运行示例演练三条路径
下面的 Python 脚本用内存状态模拟协调器。它不涉及消息队列和数据库,但完整体现“记录已完成步骤 → 遇到失败 → 倒序补偿”的控制逻辑,可直接运行观察成功、支付失败和库存失败三种结果。
class SagaError(Exception):
pass
class OrderSaga:
def create_order(self, order_id):
print(f"{order_id}: order -> PENDING")
def reserve_inventory(self, order_id, inventory_ok):
if not inventory_ok:
raise SagaError("inventory unavailable")
print(f"{order_id}: inventory reserved")
def charge_payment(self, order_id, payment_ok):
if not payment_ok:
raise SagaError("payment rejected")
print(f"{order_id}: payment charged")
def compensate(self, order_id, completed_steps):
# 只补偿已经成功的步骤,并按相反顺序执行。
for step in reversed(completed_steps):
if step == "payment":
print(f"{order_id}: payment refunded")
elif step == "inventory":
print(f"{order_id}: inventory released")
elif step == "order":
print(f"{order_id}: order -> CANCELLED")
def run(self, order_id, inventory_ok=True, payment_ok=True):
completed_steps = []
try:
self.create_order(order_id)
completed_steps.append("order")
self.reserve_inventory(order_id, inventory_ok)
completed_steps.append("inventory")
self.charge_payment(order_id, payment_ok)
completed_steps.append("payment")
print(f"{order_id}: order -> CONFIRMED")
except SagaError as error:
print(f"{order_id}: failed: {error}")
self.compensate(order_id, completed_steps)
if __name__ == "__main__":
saga = OrderSaga()
saga.run("order-1")
saga.run("order-2", payment_ok=False)
saga.run("order-3", inventory_ok=False)预期输出
order-1: order -> PENDING
order-1: inventory reserved
order-1: payment charged
order-1: order -> CONFIRMED
order-2: order -> PENDING
order-2: inventory reserved
order-2: failed: payment rejected
order-2: inventory released
order-2: order -> CANCELLED
order-3: order -> PENDING
order-3: failed: inventory unavailable
order-3: order -> CANCELLED示例中的服务调用是同步方法,真实系统通常会替换成 HTTP 或消息命令;但协调器的职责不变:推进状态、记录结果、决定重试或补偿,而不是侵入库存和支付服务的内部规则。
持久化进度而不是依赖调用栈
生产中的协调器必须把 Saga 实例持久化。至少要记录 Saga ID、当前状态、各步骤结果、重试次数以及最后一次错误。否则协调器进程在“库存已预留、支付尚未完成”时崩溃,重启后就无法判断应该继续支付还是释放库存。
一种常见状态序列是 PENDING → INVENTORY_RESERVED → PAYMENT_CHARGED → CONFIRMED。失败后不要简单回到初始状态,而是进入 COMPENSATING,直到需要的补偿全部完成,再进入 CANCELLED。补偿失败也应保留可重试状态,不能把它当成已经取消成功。
用幂等保护重试和重复消息
跨服务调用可能超时:协调器没有收到响应,不等于服务没有执行成功。因此每个命令都应带稳定的 Saga ID 和步骤 ID,库存、支付等服务据此识别重复请求,并返回第一次执行的结果。
例如 ChargePayment 已经成功,但响应丢失,协调器重试同一步时,支付服务应返回“该步骤已扣款”,而不是再次扣款。同理,ReleaseInventory 和 RefundPayment 也必须幂等,因为补偿动作同样可能重试。
编排式 Saga 的可靠性来自三件事同时成立:流程状态可持久化、每一步都能幂等重试、已完成步骤有明确补偿。协调器只负责把这些步骤连接成可恢复的状态机,领域规则仍然留在各自服务内部。