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

使用 Workflow GoRoutine 与 Channel

使用 Workflow GoRoutine 与 Channel

在 Temporal Workflow 中需要并发编排时,不能把原生 goroutine 和 channel 直接搬进工作流。这里用 workflow.Go 与 workflow.Channel 完成可重放的内部并发,并说明它们何时让出执行权、如何汇聚结果,以及哪些原生并发写法必须避开。

学习目标

  • 使用 workflow.Go 启动工作流内部协程,并用 workflow.Channel 传递结果
  • 解释 Temporal 确定性调度与 Go 运行时并发调度的关键差异
  • 判断何时使用 Workflow 内部并发,何时应并发调度 Activity

为什么不能直接用原生并发

Workflow 的代码会根据事件历史反复重放。重放要求同一段历史驱动代码时,Workflow 产生相同的命令序列;原生 goroutine、channel 和 select 的调度顺序由 Go 运行时决定,交错次序可能变化,因此不适合作为 Workflow 决策依据。

workflow.Go 创建的是由 Temporal SDK 确定性运行器管理的协程,不等于新增一个可并行执行 CPU 代码的系统 goroutine。Workflow 协程在 SDK 可感知的阻塞点让出执行权,例如等待 workflow.Channel、Future、Timer 或 Signal;同一时刻只有一个 Workflow 协程执行用户代码。

Workflow GoRoutine 与 Channel 的确定性调度关系

这也意味着,共享变量不会被两个 Workflow 协程同时读写,所以通常不需要为了防止“同时访问内存”而加锁;但如果业务语义依赖先后顺序,仍应使用 Channel、Future 等确定性同步原语明确协调。

用 Channel 汇聚并发结果

下面的完整单元测试创建三个 Workflow 协程。每个协程计算一个平方值并发送到无缓冲 workflow.Channel,主协程接收三次并求和。示例使用 Temporal 测试环境,因此不需要启动 Temporal Server。

go
package workflowexample

import (
	"fmt"
	"testing"

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

func ParallelSumWorkflow(ctx workflow.Context, values []int) (int, error) {
	results := workflow.NewChannel(ctx)

	for _, value := range values {
		value := value
		workflow.Go(ctx, func(ctx workflow.Context) {
			// Send 会在接收方未就绪时确定性阻塞,而不是阻塞 OS 线程。
			results.Send(ctx, value*value)
		})
	}

	total := 0
	for range values {
		var part int
		results.Receive(ctx, &part)
		total += part
	}
	return total, nil
}

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

	env.ExecuteWorkflow(ParallelSumWorkflow, []int{2, 3, 4})
	if err := env.GetWorkflowError(); err != nil {
		t.Fatal(err)
	}

	var got int
	if err := env.GetWorkflowResult(&got); err != nil {
		t.Fatal(err)
	}
	if got != 29 {
		t.Fatalf("want 29, got %d", got)
	}
	fmt.Println(got)
}

运行测试:

bash
go test -v -run TestParallelSumWorkflow

预期输出中测试耗时和模块路径会因环境不同而变化:

text
=== RUN   TestParallelSumWorkflow
29
--- PASS: TestParallelSumWorkflow (<TIME>)
PASS
ok  	<PATH>	<TIME>

无缓冲 Channel 让发送方与接收方形成明确同步点。如果希望允许有限数量的结果先排队,可改用 workflow.NewBufferedChannel(ctx, size);不要用缓冲区掩盖缺失的消费逻辑,否则只是把阻塞推迟。

与原生 goroutine 和 channel 的边界

需求 Workflow 内应使用 不应直接使用
启动内部并发分支 workflow.Go go func()
协程间传值 workflow.NewChannel make(chan T)
等待多个事件 workflow.NewSelector 原生 select
延时与等待 workflow.Sleep、Timer、Future time.Sleep、原生 Timer
执行网络、数据库、文件 I/O Activity 在 Workflow 协程里直接 I/O

当目标是“同时启动多个外部任务”时,更常见的做法是连续调用 workflow.ExecuteActivity 获得多个 Future,再按需要等待结果。workflow.Go 更适合组织等待、信号处理、内部流水线和多个确定性分支,而不是替代 Activity 的执行并行度。

保持并发代码可重放

判断一段 Workflow 并发代码是否安全,可以抓住一个标准:协程的创建、阻塞、恢复以及影响后续分支的值,都必须由 Temporal 能重放的状态驱动。只要业务决策依赖原生调度时机、墙上时钟、随机数或外部 I/O,重放就可能走出不同路径。

因此,内部并发优先组合 workflow.Go、workflow.Channel、Selector、Future 与 Workflow Timer。这样既能保留 Go 风格的并发表达,又把调度顺序纳入 Temporal 的确定性执行模型。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Workflow GoRoutine 与 Channel

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

登录哪都通