工作流确定性
了解为什么工作流必须是确定性的,以及如何编写确定性的代码。
重要概念
确定性意味着相同的输入总是产生相同的输出。Temporal 需要这个特性来支持工作流重放、 重试和状态恢复。
为什么需要确定性?
支持重试
当 Worker 崩溃时,工作流可以从最后的状态重新执行。如果代码不是确定性的, 重放可能产生不同的结果。
支持版本升级
确定性允许在不中断运行中的工作流的情况下升级工作流代码。
可靠的状态恢复
确保工作流在任何时候崩溃后都能从最后保存的状态正确恢复。
一致的执行历史
保证相同的工作流执行总是产生相同的事件历史,便于调试和审计。
确定性要求
必须遵守的规则
使用 Temporal 提供的 API
使用 workflow.Sleep() 而不是 time.Sleep()
// ✅ 正确
workflow.Sleep(ctx, 10*time.Second)
// ❌ 错误
time.Sleep(10*time.Second)
使用工作流时间
使用 workflow.Now() 而不是 time.Now()
// ✅ 正确
now := workflow.Now(ctx)
// ❌ 错误
now := time.Now()
避免随机数
不在工作流中使用随机数生成器,通过活动生成
// ✅ 正确 - 通过活动获取随机数
var randomNum int
workflow.ExecuteActivity(ctx, GenerateRandomNumberActivity).Get(ctx, &randomNum)
// ❌ 错误 - 直接使用随机数
randomNum := rand.Intn(100)
避免全局变量
不依赖可变的全局状态
// ❌ 错误 - 使用全局变量
var counter int
func MyWorkflow(ctx workflow.Context) {
counter++ // 不确定性
}
// ✅ 正确 - 使用局部变量或传递参数
func MyWorkflow(ctx workflow.Context, counter int) {
counter++
}
常见错误
使用系统时间
使用 time.Now() 会导致每次执行结果不同。
直接调用外部 API
应该通过活动调用外部 API,而不是直接在工作流中调用。
使用 goroutine
Go 工作流不支持 goroutine,应该使用 Temporal 的并发原语。
直接访问数据库
应该通过活动访问数据库,确保操作的原子性。
并发处理
Temporal 提供了专门的 API 来处理并发,确保确定性的并发执行。
parallel.go
package main
import (
"go.temporal.io/sdk/workflow"
)
func ParallelWorkflow(ctx workflow.Context) error {
// 创建 Future 集合
var futures []workflow.Future
// 并发执行多个活动
for i := 0; i < 5; i++ {
future := workflow.ExecuteActivity(ctx, MyActivity, i)
futures = append(futures, future)
}
// 等待所有活动完成
for _, future := range futures {
var result int
err := future.Get(ctx, &result)
if err != nil {
return err
}
}
return nil
}
测试确定性
test.go
package main
import (
"testing"
"go.temporal.io/sdk/workflow"
"go.temporal.io/sdk/workflow/testing"
)
func TestMyWorkflowDeterminism(t *testing.T) {
// 创建测试环境
testEnv := testing.NewWorkflowTestEnvironment()
// 注册活动
testEnv.RegisterActivity(MyActivity)
// 执行工作流
testEnv.ExecuteWorkflow(MyWorkflow, "test-input")
// 验证结果
var result string
testEnv.GetWorkflowResult(&result)
// 确保每次执行结果相同
if result != "expected-result" {
t.Errorf("Unexpected result: %s", result)
}
}
总结
- ✅ 工作流必须是确定性的
- ✅ 使用 Temporal 提供的 API
- ✅ 避免随机、时间和外部调用
- ✅ 通过活动执行非确定性操作
- ✅ 使用测试工具验证确定性
版权与许可:Temporal 官方文档及其中文译文项目采用 MIT License;保留原作者声明,详见许可证。