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

用编排式 Saga 控制流程

用编排式 Saga 控制流程

编排式 Saga 适合步骤多、分支多且需要统一恢复策略的跨服务流程。核心不是让协调器替所有服务做业务,而是让它持有流程状态,按顺序发送命令,并在失败时触发对应补偿。本课以订单、库存和支付为例搭出一条可恢复的编排链路。

学习目标

  • 划分 Saga 协调器与领域服务各自负责的逻辑。
  • 为正常步骤、失败分支和补偿动作建立明确状态。
  • 用幂等命令与持久化进度保证流程可重试、可恢复。

协调器只负责流程决策

编排式 Saga 中,协调器知道“下一步做什么”,领域服务只负责“这一步业务能否完成”。例如协调器可以要求库存服务预留商品,但库存是否足够、如何锁定库存仍由库存服务内部规则决定。

典型顺序是:创建待处理订单,预留库存,扣款,最后确认订单。任何一步失败,协调器根据已经成功的步骤倒序执行补偿。这样正常路径和恢复路径都集中在同一流程模型中,便于观察和测试。

订单编排式 Saga 的正向与补偿路径

把每一步和补偿成对设计

为每个正向动作预先定义补偿,比“失败后再想怎么办”可靠。可以把流程看成一组有顺序的动作:CreateOrder 对应 CancelOrder,ReserveInventory 对应 ReleaseInventory,ChargePayment 对应 RefundPayment。

补偿只对已经成功的步骤执行,并且通常按相反顺序进行。支付尚未成功就不应退款,库存尚未预留也不应释放。协调器因此必须记录每一步的完成状态,而不能只保存一个粗粒度的“处理中”。

用可运行示例演练三条路径

下面的 Python 脚本用内存状态模拟协调器。它不涉及消息队列和数据库,但完整体现“记录已完成步骤 → 遇到失败 → 倒序补偿”的控制逻辑,可直接运行观察成功、支付失败和库存失败三种结果。

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)

预期输出

text
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 的可靠性来自三件事同时成立:流程状态可持久化、每一步都能幂等重试、已完成步骤有明确补偿。协调器只负责把这些步骤连接成可恢复的状态机,领域规则仍然留在各自服务内部。

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

目录与阅读设置

阅读设置

17

记录一个想法

用编排式 Saga 控制流程

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

登录哪都通