服务注册与分布式协调 / 系统课时
等待外部条件并设置超时
等待外部条件并设置超时
人工审批、第三方回调和线下确认都可能让流程停上数小时甚至数天。本课把“等事件”和“到期兜底”都建模进 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 与 Timer 竞争
下面用 Go SDK 测试环境验证两个分支。测试环境会自动推进 Workflow 虚拟时间,所以 24*time.Hour 不会真的等待一天。把代码保存为已引入 go.temporal.io/sdk 的 Go module 中的 approval_test.go 后执行 go test -v。
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)
}
}预期输出
=== 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 重启,也不会因为某个进程消失而永久卡住。