服务注册与分布式协调 / 系统课时
使用 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 协程同时读写,所以通常不需要为了防止“同时访问内存”而加锁;但如果业务语义依赖先后顺序,仍应使用 Channel、Future 等确定性同步原语明确协调。
用 Channel 汇聚并发结果
下面的完整单元测试创建三个 Workflow 协程。每个协程计算一个平方值并发送到无缓冲 workflow.Channel,主协程接收三次并求和。示例使用 Temporal 测试环境,因此不需要启动 Temporal Server。
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)
}运行测试:
go test -v -run TestParallelSumWorkflow预期输出中测试耗时和模块路径会因环境不同而变化:
=== 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 的确定性执行模型。