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

等待外部条件并设置超时

等待外部条件并设置超时

人工审批、第三方回调和线下确认都可能让流程停上数小时甚至数天。本课把“等事件”和“到期兜底”都建模进 Workflow:外部结果通过 Signal 到达,超时由 Temporal 的持久化 Timer 驱动,Worker 重启后仍能从历史恢复等待状态。

学习目标

  • 用 Signal 和持久化 Timer 表达外部事件与业务截止时间
  • 根据场景选择 Await、AwaitWithTimeout 或 Selector
  • 为超时、拒绝和非法信号设计明确的兜底结果

把等待交给 Temporal 而不是 Worker

Workflow 的等待不是让某个 Worker 线程一直睡眠。Signal 会成为事件历史的一部分,Timer 也由 Temporal 服务持久化;Worker 可以停止、迁移或重启,新的 Worker 通过重放历史恢复到同一个等待点。因此,长流程不需要自行维护“睡眠中的进程”。

当等待条件只是某个状态变为真时,可以使用 workflow.Await。如果条件还必须在指定时限内满足,优先使用 workflow.AwaitWithTimeout。若业务必须明确区分“哪个 Signal 到达”和“Timer 先到期”,workflow.Selector 更直观,因为它能让多个可等待事件竞争。

Signal 与业务超时的竞争关系

让 Signal 与 Timer 竞争

下面用 Go SDK 测试环境验证两个分支。测试环境会自动推进 Workflow 虚拟时间,所以 24*time.Hour 不会真的等待一天。把代码保存为已引入 go.temporal.io/sdk 的 Go module 中的 approval_test.go 后执行 go test -v。

go
package approval

import (
	"testing"
	"time"

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

type ApprovalSignal struct {
	Decision string
}

func ApprovalWorkflow(ctx workflow.Context, timeout time.Duration) (string, error) {
	signalCh := workflow.GetSignalChannel(ctx, "approval")
	timer := workflow.NewTimer(ctx, timeout)

	result := ""
	for result == "" {
		selector := workflow.NewSelector(ctx)

		selector.AddReceive(signalCh, func(c workflow.ReceiveChannel, more bool) {
			var sig ApprovalSignal
			c.Receive(ctx, &sig)
			switch sig.Decision {
			case "approved", "rejected":
				result = sig.Decision
			}
		})

		selector.AddFuture(timer, func(workflow.Future) {
			result = "manual-review"
		})

		selector.Select(ctx)
	}

	return result, nil
}

func TestApprovalBySignal(t *testing.T) {
	var suite testsuite.WorkflowTestSuite
	env := suite.NewTestWorkflowEnvironment()

	env.RegisterDelayedCallback(func() {
		env.SignalWorkflow("approval", ApprovalSignal{Decision: "approved"})
	}, 6*time.Hour)

	env.ExecuteWorkflow(ApprovalWorkflow, 24*time.Hour)

	var got string
	if err := env.GetWorkflowResult(&got); err != nil {
		t.Fatal(err)
	}
	if got != "approved" {
		t.Fatalf("got %q, want approved", got)
	}
}

func TestApprovalTimeout(t *testing.T) {
	var suite testsuite.WorkflowTestSuite
	env := suite.NewTestWorkflowEnvironment()

	env.ExecuteWorkflow(ApprovalWorkflow, 24*time.Hour)

	var got string
	if err := env.GetWorkflowResult(&got); err != nil {
		t.Fatal(err)
	}
	if got != "manual-review" {
		t.Fatalf("got %q, want manual-review", got)
	}
}

预期输出

text
=== RUN   TestApprovalBySignal
--- PASS: TestApprovalBySignal (<TIME>)
=== RUN   TestApprovalTimeout
--- PASS: TestApprovalTimeout (<TIME>)
PASS
ok  	<PATH>	<TIME>

实际耗时和包路径会不同。第一个测试证明 Signal 在 Timer 前到达时返回审批结果;第二个测试没有发送 Signal,虚拟时间推进到截止点后进入 manual-review。

处理边界而不是永久等待

业务超时应表达“这件事最多等多久”,而不是依赖 Workflow Run Timeout 来替代。前者可以进入人工复核、自动拒绝或补偿分支;后者属于执行级约束,语义不同。

Signal 还要考虑重复、乱序和非法值。示例对未知 Decision 只消费而不结束等待;生产代码通常还应带审批 ID、版本或幂等键,避免旧审批覆盖新请求。如果状态由多个 Signal 或 Update handler 共同维护,可以让 handler 只更新状态,再用 workflow.AwaitWithTimeout 等待“状态满足或超时”,不要在 Await 条件函数里执行接收消息、写外部系统等副作用。

只要把外部事件、时间截止和兜底结果都放进 Workflow 状态机,流程即使跨越多次 Worker 重启,也不会因为某个进程消失而永久卡住。

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

目录与阅读设置

阅读设置

17

记录一个想法

等待外部条件并设置超时

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

登录哪都通