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

理解 Replay 与确定性约束

理解 Replay 与确定性约束

Temporal 能在 Worker 重启、缓存淘汰或代码重新部署后继续同一个 Workflow,关键不是保存进程栈,而是保存事件历史并重放 Workflow 代码。本篇用 Go SDK 说明 Replay 如何工作,以及为什么时间、随机数、网络 I/O 和普通 goroutine 不能直接决定 Workflow 的执行路径。

学习目标

  • 说清 Event History、Replay 与确定性之间的关系
  • 识别四类常见非确定性来源,并选择 Temporal 对应替代方案
  • 判断一次代码修改是否可能让已有 Workflow 历史无法重放

Replay 为什么要求同一条历史走同一路径

Workflow 首次执行时,代码会通过 SDK 产生“调度 Activity、启动 Timer、完成 Workflow”等命令,Temporal Service 将命令对应的结果记录为 Event History。以后某个 Worker 接手同一执行时,SDK 会从头运行 Workflow,并用已有历史恢复此前已经发生的结果,而不是重新执行那些外部动作。

因此,确定性的核心要求不是“每次 CPU 执行完全一样”,而是:给定相同输入和相同 Event History,Workflow 必须产生与历史兼容的命令序列。 如果重放时走到另一条分支,原历史期待一个 Timer,而新代码却尝试调度 Activity,就可能出现 nondeterminism 错误。

Workflow 首次执行与 Replay 对事件历史的匹配关系

常见非确定性从哪里进入

下面这些 API 在普通 Go 服务里很自然,但直接放进 Workflow 决策路径会绕过 Temporal 的历史记录或确定性调度。

非确定性来源 风险 Workflow 中的做法
time.Now()、time.Sleep()、time.NewTimer() 本机时间与重放时刻不同 使用 workflow.Now()、workflow.Sleep()、workflow.NewTimer()
rand.*、临时 UUID 每次重放可能得到不同值 对短小本地计算使用 workflow.SideEffect(),或把值作为输入、Activity 结果传入
HTTP、数据库、文件系统等直接 I/O 重放可能再次访问外部系统,结果和副作用都不可控 放入 Activity,通过历史记录 Activity 结果
go、原生 chan、原生 select Go 调度顺序不由 Temporal 控制 使用 workflow.Go()、Workflow Channel 和 workflow.Selector

用历史记录封住随机性

workflow.SideEffect() 会在首次执行时运行回调并把结果写入历史;Replay 时直接读取已记录结果,不再次执行回调。下面的完整测试演示一个安全的随机值用法。它假设当前 Go module 已添加 go.temporal.io/sdk 依赖。

go
package replay

import (
	"math/rand/v2"
	"testing"

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

func StableWorkflow(ctx workflow.Context) (int, error) {
	// 随机值只能在 SideEffect 内生成,重放时读取历史中的同一个结果。
	encoded := workflow.SideEffect(ctx, func(ctx workflow.Context) interface{} {
		return rand.IntN(1000)
	})

	var value int
	if err := encoded.Get(&value); err != nil {
		return 0, err
	}
	return value, nil
}

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

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

	var value int
	if err := env.GetWorkflowResult(&value); err != nil {
		t.Fatal(err)
	}
	if value < 0 || value >= 1000 {
		t.Fatalf("unexpected value: %d", value)
	}
}

运行测试:

bash
go test -run TestStableWorkflow -v

预期输出:

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

<TIME> 是本地测试耗时,实际值会不同。这个测试证明调用方式可以正常执行;真正的 Replay 兼容性还应在发布前用代表性的历史记录回放验证。

修改 Workflow 时先看命令序列

对纯计算、局部变量名或不影响控制流的重构,通常不会改变历史对应的命令。风险更高的是改变 Activity、Timer、Child Workflow 等命令的出现条件、顺序或数量,因为仍在运行的旧 Workflow 可能已经拥有与新代码不同的历史。

判断修改是否安全时,可以先问两个问题:同一条旧历史重放到当前代码时会走哪条分支?走到每个历史事件位置时,新代码期待的命令类型和顺序是否仍与历史一致?只要答案不确定,就应把“历史重放测试”作为上线门禁,而不是只验证新启动的 Workflow。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解 Replay 与确定性约束

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

登录哪都通