工作流确定性

了解为什么工作流必须是确定性的,以及如何编写确定性的代码。

重要概念

确定性意味着相同的输入总是产生相同的输出。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 中文文档:工作流确定性。

版权与许可:Temporal 官方文档及其中文译文项目采用 MIT License;保留原作者声明,详见许可证。

results matching ""

    No results matching ""