服务注册与分布式协调 / 系统课时
理解 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 错误。

常见非确定性从哪里进入
下面这些 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 依赖。
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)
}
}运行测试:
go test -run TestStableWorkflow -v预期输出:
=== RUN TestStableWorkflow
--- PASS: TestStableWorkflow (<TIME>)
PASS<TIME> 是本地测试耗时,实际值会不同。这个测试证明调用方式可以正常执行;真正的 Replay 兼容性还应在发布前用代表性的历史记录回放验证。
修改 Workflow 时先看命令序列
对纯计算、局部变量名或不影响控制流的重构,通常不会改变历史对应的命令。风险更高的是改变 Activity、Timer、Child Workflow 等命令的出现条件、顺序或数量,因为仍在运行的旧 Workflow 可能已经拥有与新代码不同的历史。
判断修改是否安全时,可以先问两个问题:同一条旧历史重放到当前代码时会走哪条分支?走到每个历史事件位置时,新代码期待的命令类型和顺序是否仍与历史一致?只要答案不确定,就应把“历史重放测试”作为上线门禁,而不是只验证新启动的 Workflow。