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

使用 Workflow 时间与 Timer

使用 Workflow 时间与 Timer

Workflow 往往需要等待几分钟、几天甚至几个月。若直接使用进程本地时钟或线程睡眠,Worker 重启后就无法可靠恢复。本篇用 Go SDK 的 workflow.Now()、workflow.Sleep() 和 workflow.NewTimer() 构建可重放的时间逻辑,并解释为什么长时间等待不会占住 Worker 线程。

学习目标

  • 使用 Workflow 时间替代进程本地时钟
  • 区分 workflow.Sleep() 与 workflow.NewTimer() 的使用方式
  • 理解 Timer 如何持久化等待,并在 Worker 不常驻的情况下恢复执行

Workflow 时间不是进程墙上时钟

workflow.Now(ctx) 返回 Temporal 为当前 Workflow Task 提供的时间。在同一次 Workflow Task 内,它不会像 time.Now() 那样随着代码执行持续变化;当 Timer 触发、Signal 到达或其他事件导致新的 Workflow Task 开始时,Workflow 时间才会随历史推进。

因此,所有会影响 Workflow 分支的“现在几点”判断都应基于 workflow.Now(ctx)。如果输入给了绝对截止时间,可先计算 remaining := deadline.Sub(workflow.Now(ctx)),到期则直接继续,未到期则创建 Temporal Timer。这样同一条历史在 Replay 时会得到相同的时间判断。

Sleep 如何变成持久化等待

workflow.Sleep(ctx, d) 不是让某个 OS 线程调用 time.Sleep。SDK 会请求 Temporal 创建一个持久化 Timer,当前 Workflow 协程挂起后,Worker 就可以去处理别的任务,甚至整个 Worker 进程都可以停掉。

Timer 到期后,Temporal Service 记录 Timer 已触发,并生成新的 Workflow Task。任意可用 Worker 领取任务后先 Replay Event History,再从等待之后的位置继续逻辑。等待十分钟和等待十天,对 Worker 来说都不需要保留一个线程。

Temporal Timer 从创建到触发并恢复 Workflow 的生命周期

Sleep 与 NewTimer 怎么选

workflow.Sleep() 适合“创建等待并立刻等到它结束”的线性流程,返回 nil 表示时间到达;如果关联的 Workflow Context 被取消,则返回取消错误。

workflow.NewTimer() 会立即返回一个 workflow.Future,Timer 在后台由 Temporal 管理。你可以稍后调用 Future.Get() 等待它,也可以把 Future 放进 workflow.Selector,实现“Signal 先到就处理 Signal,Timer 先到就走超时分支”这类竞速逻辑。需要可组合等待时,NewTimer() 比 Sleep() 更合适。

验证两段时间等待

下面的完整 Go 测试先用 workflow.Sleep() 等待 2 小时,再用 workflow.NewTimer() 等待 30 分钟,最终检查 Workflow 时间共推进 2 小时 30 分钟。Temporal 测试环境会推进逻辑时间,因此不需要真实等待这么久。

go
package timers

import (
	"testing"
	"time"

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

func TimerWorkflow(ctx workflow.Context) (time.Duration, error) {
	startedAt := workflow.Now(ctx)

	if err := workflow.Sleep(ctx, 2*time.Hour); err != nil {
		return 0, err
	}

	// NewTimer 先返回 Future;调用 Get 时才等待它变为 ready。
	timer := workflow.NewTimer(ctx, 30*time.Minute)
	if err := timer.Get(ctx, nil); err != nil {
		return 0, err
	}

	return workflow.Now(ctx).Sub(startedAt), nil
}

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

	env.ExecuteWorkflow(TimerWorkflow)
	if err := env.GetWorkflowError(); err != nil {
		t.Fatal(err)
	}

	var elapsed time.Duration
	if err := env.GetWorkflowResult(&elapsed); err != nil {
		t.Fatal(err)
	}
	if elapsed != 150*time.Minute {
		t.Fatalf("want 2h30m, got %s", elapsed)
	}
}

运行测试:

bash
go test -run TestTimerWorkflow -v

预期输出:

text
=== RUN   TestTimerWorkflow
--- PASS: TestTimerWorkflow (<TIME>)
PASS

<TIME> 是本地测试耗时,并不是 Workflow 的逻辑等待时间。测试能很快结束,正好体现了“业务时间推进”和“Worker 实际占用时间”是两件不同的事。

时间逻辑的边界

业务代码只要需要“等到某个时刻再继续”,优先使用 Temporal Timer;只有真正发生在外部系统里的等待,例如第三方接口调用本身耗时,才属于 Activity 的执行时间。Timer 负责可靠地等待,Activity 负责可靠地执行外部副作用,这个边界能让 Replay、重试和 Worker 故障恢复保持清晰。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Workflow 时间与 Timer

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

登录哪都通