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

使用 Future 组织并行等待

使用 Future 组织并行等待

当一个 Workflow 需要同时调用多个互不依赖的 Activity 或 Child Workflow 时,关键不是创建更多 Go goroutine,而是先拿到多个 Future,再在真正需要结果的位置等待。这样可以让可并行步骤尽早被调度,同时保持 Workflow 控制流可重放、可恢复。

学习目标

  • 理解 Future 在 Temporal Workflow 中表示什么,以及 Get 为什么会影响串并行结构
  • 用“先调度、后等待”的方式并发执行多个 Activity,并正确汇聚结果
  • 识别错误处理、取消和大规模并发时的关键边界

Future 把调度和取结果分开

workflow.ExecuteActivity 会立即返回 workflow.Future。Future 代表一个尚未完成、但之后会产生结果或错误的异步计算;Workflow 只有在调用 Future.Get 且结果尚未就绪时才会挂起当前协程,等待对应历史事件到来。

因此,下面两种写法的差别不在 Get 本身,而在第二个任务是否已经被调度。如果执行一个 Activity 后立刻 Get,后续 Activity 要等第一个完成后才有机会被安排;如果先连续调用多次 ExecuteActivity,这些命令可以在同一轮 Workflow 推进中被提交,再按需要读取结果。

Future 先并行调度再汇聚结果的数据流

先调度,再汇聚

下面是片段示例:假设这些 Workflow 与 Activity 已注册到 Temporal Worker。三个 Activity 互不依赖,因此 Workflow 先保存三个 Future,再读取结果。Get 的书写顺序固定,但 Activity 的实际完成顺序不必一致。

go
package workflows

import (
    "context"
    "fmt"
    "time"

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

type ProductView struct {
    Price    int
    Stock    int
    Shipping string
}

func LoadPrice(ctx context.Context, sku string) (int, error) {
    return 1999, nil
}

func LoadStock(ctx context.Context, sku string) (int, error) {
    return 12, nil
}

func LoadShipping(ctx context.Context, sku string) (string, error) {
    return "next-day", nil
}

func BuildProductView(ctx workflow.Context, sku string) (ProductView, error) {
    ctx = workflow.WithActivityOptions(ctx, workflow.ActivityOptions{
        StartToCloseTimeout: time.Minute,
    })

    // 先创建全部异步工作,避免在第一个结果上过早阻塞。
    priceFuture := workflow.ExecuteActivity(ctx, LoadPrice, sku)
    stockFuture := workflow.ExecuteActivity(ctx, LoadStock, sku)
    shippingFuture := workflow.ExecuteActivity(ctx, LoadShipping, sku)

    var result ProductView
    if err := priceFuture.Get(ctx, &result.Price); err != nil {
        return ProductView{}, fmt.Errorf("load price: %w", err)
    }
    if err := stockFuture.Get(ctx, &result.Stock); err != nil {
        return ProductView{}, fmt.Errorf("load stock: %w", err)
    }
    if err := shippingFuture.Get(ctx, &result.Shipping); err != nil {
        return ProductView{}, fmt.Errorf("load shipping: %w", err)
    }

    return result, nil
}

预期结果(以客户端打印 Workflow 返回值为例):

text
price=1999 stock=12 shipping=next-day

三个 Activity 的完成先后可能不同,但只要都成功,汇聚出的业务结果一致。真正的并发上限仍受 Activity Worker 并发配置、Task Queue 和下游资源容量约束;Future 负责的是编排层的异步依赖,而不是强制三个远程任务在同一时刻开始。

处理失败与取消

Future.Get 返回的错误应立即进入业务定义的失败策略。若三个任务彼此独立,可以继续读取其他 Future 并汇总部分结果;若要求 fail-fast,可以从 workflow.WithCancel 派生活动上下文,在关键分支失败后取消尚未完成的工作。

取消不是“强杀” Activity。长时间 Activity 如果希望及时感知取消,应按照 Activity 的取消与心跳机制实现可中断逻辑。对 Child Workflow 也是同样思路:workflow.ExecuteChildWorkflow 返回 Child Workflow Future,先启动多个子流程,再按依赖关系等待即可。

判断代码是否真的并行

检查串行化最简单的方法,是沿着 Workflow 代码寻找过早的 Get。如果第二个 ExecuteActivity 出现在第一个 Get 之后,那么第二个 Activity 的调度天然依赖第一个结果;如果所有 ExecuteActivity 都先执行,再进入 Get 阶段,则编排关系才是并行扇出、统一汇聚。

Future 的核心价值就是把“发起工作”和“消费结果”拆开。先根据数据依赖决定哪些任务可以同时发起,再在真正需要值的位置等待,通常比为了并发而引入额外 Workflow 协程更直接,也更容易在历史重放时保持清晰的控制流。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Future 组织并行等待

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

登录哪都通