Saga Orchestration 是一套用于管理分布式事务与长运行业务流程的模式实现,目标是在不使用两阶段提交(two-phase commit)的前提下,协调跨服务的事务与补偿。该技能适合在需要跨多个服务保持一致性、但无法使用分布式锁的场景中落地 Saga 模式。
一、用途
- 协调多服务事务,避免分布式锁。
- 为部分失败实现补偿事务(compensating transactions)。
- 管理长运行业务工作流(从分钟级到小时级)。
- 在分布式系统中处理原子性要求下的失败场景。
- 构建订单履约、审批或预订等流程。
- 用异步补偿替代脆弱的两阶段提交。
二、主要能力(输出内容)
- Saga 定义:包含有序步骤、动作命令(action commands)与补偿命令(compensation commands)。
- 编排(orchestrator)或协同(choreography)实现,按所选模式生成。
- 每个参与服务的补偿逻辑:要求幂等、并且始终成功返回。
- 步骤超时配置:为每一步设置独立的截止时间(deadline)。
- 监控设置:状态机指标、卡死 Saga 检测、死信队列(DLQ)恢复。
三、使用方式 需要你先提供以下输入:
- 服务边界与归属(哪个服务拥有哪个步骤)。
- 事务要求(哪些步骤必须原子,哪些可以最终一致)。
- 每一步的失败模式(瞬时失败 vs 永久失败、重试策略)。
- 每一步的 SLA 要求(用于决定超时配置)。
- 现有的事件/消息基础设施(如 Kafka、RabbitMQ、SQS)。
基于这些输入,技能会产出上述 Saga 定义、实现、补偿逻辑、超时配置与监控方案。相关细节(核心概念、模板)被移至 references/details.md;进阶实现位于 references/advanced-patterns.md,包括完整的 SagaOrchestrator 抽象基类、带逐步截止时间的 TimeoutSagaOrchestrator、银行转账补偿事务链、Prometheus 埋点、卡死 Saga 的 PromQL 告警以及 DLQ 恢复 worker。
四、最佳实践 应当遵循:
- 让每一步都幂等——命令可能因 broker 重连而重放。
- 谨慎设计补偿逻辑——它是最关键的代码路径。
- 使用关联 ID——saga_id 必须贯穿每个事件与日志。
- 实现逐步超时——永远不要无限等待参与方回复。
- 记录状态转换——每次变化记录 saga_id、step_name、old_state → new_state。
- 显式测试补偿路径——在集成测试中于每个步骤下标注入失败。
应当避免:
- 假设立即完成——Saga 是异步的,可能耗时数分钟。
- 跳过补偿测试——回滚路径最难做对。
- 直接耦合服务——使用异步消息,永远不要在 Saga 步骤内用同步调用。
- 忽略部分失败——已部分执行的步骤仍需补偿。
- 使用全局超时——每个步骤的延迟特征不同。
五、常见问题与排查
- Saga 卡在 COMPENSATING 状态:补偿处理器抛出未捕获异常且未发布 SagaCompensationCompleted。应为补偿消费者添加 DLQ 处理,并确保每个补偿动作都发布结果事件,即使底层操作已回滚。示例:handle_release_reservation 在遇到 ReservationNotFoundError 时视为已释放成功,但仍始终发布 SagaCompensationCompleted。
- 重启后重复执行 Saga:编排服务在 Saga 中途重启可能重放事件并重新执行已完成步骤。应为每个步骤动作加幂等键保护。
- 协同式 Saga 丢失事件:下游服务在事件发布时离线可能错过事件。应使用持久化消息 broker(带复制的 Kafka、带持久化的 RabbitMQ),并把当前 Saga 状态存入专用 saga_log 表,以便从最后一个已知良好步骤重放。
- 超时早于慢但有效的步骤完成:例如 create_shipment 高峰时可能需 15 分钟,而全局超时仅 5 分钟,会触发误补偿。应按步骤类型配置超时,参考 references/advanced-patterns.md 中的 TimeoutSagaOrchestrator 与 STEP_TIMEOUTS 字典模式。
- 补偿顺序与执行顺序不一致:当两个步骤都已完成才检测到失败时,补偿必须严格逆序执行,否则数据会不一致。应验证 _compensate() 从 current_step - 1 倒序迭代到 0,并添加在每个步骤下标故意失败的集成测试以确认回滚顺序。
六、相关技能
- cqrs-implementation:将 Saga 与 CQRS 配合,在每步完成后更新读模型。
- event-store-design:把 Saga 事件存入事件存储,获得完整审计轨迹与重放能力。
- workflow-orchestration-patterns:更高层的工作流引擎(Temporal、Conductor),构建在 Saga 概念之上。
七、限制 资料未提供具体的收费、价格、平台支持范围或效果承诺信息。