服务注册与分布式协调 / 系统课时

建模订单履约长流程

建模订单履约长流程

订单履约不能只把接口串起来,还要承受长时间等待、跨服务失败、人工介入与重复消息。本课把支付、库存、审批、发货和取消建成可恢复的 Temporal Workflow,并明确重试、外部事件与补偿边界。

学习目标

  • 把订单履约拆成稳定的 Workflow 状态与外部副作用
  • 正确区分 Activity、Signal、Update 和子 Workflow 的职责
  • 为失败、审批超时和不可逆发货设计补偿边界

先把业务事实变成状态

先只保留会影响后续分支、等待条件和补偿决策的状态。一个可用的主路径可以是 CREATED → PAYMENT_CONFIRMED → INVENTORY_RESERVED → WAITING_APPROVAL → SHIPPING → COMPLETED。拒绝或等待超时则进入 CANCELING,补偿完成后落到 CANCELED。

支付网关的完整交易对象、仓库库位等细节不需要复制进 Workflow 状态;Workflow 只保存后续编排真正需要的业务标识,例如 paymentID、reservationID、当前收货地址和审批结果。这样既能重放决策,也不会把编排层变成另一个业务数据库。

订单履约状态与补偿边界

把交互放到正确的 Temporal 原语

需要访问支付、库存、物流等外部系统的动作放进 Activity,因为它们可能失败、超时或被重试。Activity 应携带稳定业务键,例如 orderID 或操作 ID,让下游把重复调用识别为同一次业务操作;“Temporal 会重试”不等于“外部接口天然幂等”。

人工审批更适合 Signal。审批方只负责提交“批准/拒绝”事件,Workflow 可以在之后处理它;Signal 调用成功表示服务端接受了信号,并不代表订单已经完成审批分支。若调用方必须立即知道修改是否被接受,例如“发货前修改收货地址”,则使用 Update,并在 Validator 中拒绝空地址或已进入发货阶段的修改。

发货如果本身还有“创建运单、等待承运商回执、处理物流异常”等独立生命周期,可以拆成子 Workflow。父 Workflow 只关心子流程的业务结果,这样履约主流程不会被物流内部细节淹没。

补偿不是数据库回滚

Saga 式补偿只撤销已经成功产生的业务副作用。支付成功而库存预留最终失败,需要退款;支付和库存都成功,但审批拒绝或超时,则通常先释放库存,再退款。补偿顺序一般与正向动作相反,因为后执行的动作往往依赖先执行的结果。

一旦承运商已经受理发货,就不要把“取消订单”简单建模成退款加释放库存。此时可能需要拦截包裹、退货或人工介入,属于新的业务流程。补偿 Activity 本身也可能失败,因此同样要有超时、重试和幂等键,不能把补偿写成一次性的 best effort。

把模型落成 Workflow 骨架

片段示例:下面代码只表达状态、等待和补偿边界,依赖 Worker 已注册 ConfirmPayment、ReserveInventory、ReleaseInventory、RefundPayment 与 ShippingWorkflow,不是独立可运行程序。

go
package fulfillment

import (
	"fmt"
	"time"

	"go.temporal.io/sdk/workflow"
)

type OrderInput struct {
	OrderID         string
	Address         string
	ApprovalTimeout time.Duration
}

type Approval struct {
	Approved bool
	Approver string
}

func FulfillmentWorkflow(ctx workflow.Context, in OrderInput) error {
	state := "CREATED"
	address := in.Address
	ctx = workflow.WithActivityOptions(ctx, workflow.ActivityOptions{
		StartToCloseTimeout: 30 * time.Second,
	})

	// Update 需要同步给调用方“接受或拒绝”的结果,并保护发货后的地址。
	err := workflow.SetUpdateHandlerWithOptions(
		ctx,
		"update-address",
		func(ctx workflow.Context, next string) (string, error) {
			address = next
			return address, nil
		},
		workflow.UpdateHandlerOptions{
			Validator: func(next string) error {
				if next == "" || state == "SHIPPING" || state == "COMPLETED" || state == "CANCELING" || state == "CANCELED" {
					return fmt.Errorf("address cannot be changed in state %s", state)
				}
				return nil
			},
		},
	)
	if err != nil {
		return err
	}

	var paymentID, reservationID string
	if err := workflow.ExecuteActivity(ctx, "ConfirmPayment", in.OrderID).Get(ctx, &paymentID); err != nil {
		return err
	}
	state = "PAYMENT_CONFIRMED"

	if err := workflow.ExecuteActivity(ctx, "ReserveInventory", in.OrderID).Get(ctx, &reservationID); err != nil {
		if refundErr := workflow.ExecuteActivity(ctx, "RefundPayment", paymentID).Get(ctx, nil); refundErr != nil {
			return fmt.Errorf("reserve inventory failed: %v; refund failed: %w", err, refundErr)
		}
		return err
	}
	state = "INVENTORY_RESERVED"

	// Signal 与耐久 Timer 竞争,Workflow 不需要占用线程轮询审批结果。
	state = "WAITING_APPROVAL"
	var approval Approval
	timedOut := false
	selector := workflow.NewSelector(ctx)
	selector.AddReceive(workflow.GetSignalChannel(ctx, "approval"), func(ch workflow.ReceiveChannel, more bool) {
		ch.Receive(ctx, &approval)
	})
	selector.AddFuture(workflow.NewTimer(ctx, in.ApprovalTimeout), func(workflow.Future) {
		timedOut = true
	})
	selector.Select(ctx)

	if timedOut || !approval.Approved {
		state = "CANCELING"
		if err := workflow.ExecuteActivity(ctx, "ReleaseInventory", reservationID).Get(ctx, nil); err != nil {
			return err
		}
		if err := workflow.ExecuteActivity(ctx, "RefundPayment", paymentID).Get(ctx, nil); err != nil {
			return err
		}
		state = "CANCELED"
		return workflow.Await(ctx, func() bool { return workflow.AllHandlersFinished(ctx) })
	}

	state = "SHIPPING"
	childCtx := workflow.WithChildOptions(ctx, workflow.ChildWorkflowOptions{
		WorkflowID: "shipping-" + in.OrderID,
	})
	if err := workflow.ExecuteChildWorkflow(childCtx, "ShippingWorkflow", in.OrderID, address).Get(childCtx, nil); err != nil {
		return err
	}
	state = "COMPLETED"
	return workflow.Await(ctx, func() bool { return workflow.AllHandlersFinished(ctx) })
}

预期结果

text
批准:CREATED -> PAYMENT_CONFIRMED -> INVENTORY_RESERVED -> WAITING_APPROVAL -> SHIPPING -> COMPLETED
拒绝或超时:CREATED -> PAYMENT_CONFIRMED -> INVENTORY_RESERVED -> WAITING_APPROVAL -> CANCELING -> CANCELED
库存预留最终失败:CREATED -> PAYMENT_CONFIRMED -> RefundPayment -> Workflow 失败

这个骨架还没有展开生产级错误分类,但关键边界已经固定:Workflow 保存决策状态,Activity 承担外部副作用,Signal 驱动异步审批,Update 处理需要同步确认的变更,子 Workflow 隔离独立生命周期。后续实现时应围绕这些边界补充重试、可观测性和补偿失败处理,而不是重新改变业务状态含义。

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

目录与阅读设置

阅读设置

17

记录一个想法

建模订单履约长流程

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

登录哪都通