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

使用 Selector 处理多路事件

使用 Selector 处理多路事件

当 Workflow 同时等待 Activity Future、Timer 和 Signal 时,直接用 Go 原生 select 并不符合 Temporal Workflow 的确定性执行模型。本课用 workflow.Selector 把多个可恢复事件统一成可重放的控制流。

学习目标

  • 能用 workflow.NewSelector 注册 Future、Timer 和 Signal 分支
  • 能理解 Select 如何等待第一个可处理事件并执行对应回调
  • 能处理超时、人工抢占和多个分支同时就绪时的确定性边界

Selector 解决什么问题

Workflow 中的等待不是普通 Go 协程之间的内存同步。Temporal 需要让 Workflow 在故障恢复和重放时沿着同样的逻辑继续执行,因此 Workflow 代码应使用 SDK 提供的确定性等待原语,而不是依赖 Go runtime 的调度结果。

workflow.NewSelector(ctx) 可以注册多个等待来源。常见分支包括 AddFuture、AddReceive 和基于 workflow.NewTimer 得到的 Future。每次调用 Select 时,如果当前没有分支就绪,Workflow 会挂起;有分支就绪后,则执行一个匹配分支的回调。

Temporal Workflow Selector 多路事件竞争关系

用一个 Workflow 同时等待三路事件

下面的片段示范一个常见模式:启动一个 Activity 得到 Future,同时创建超时 Timer,再监听 cancel-requested Signal。哪个事件先完成,就先处理哪个结果。

go
package workflows

import (
    "time"

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

func WaitForFirstEvent(ctx workflow.Context) (string, error) {
    activityCtx := workflow.WithActivityOptions(ctx, workflow.ActivityOptions{
        StartToCloseTimeout: time.Minute,
    })

    activityFuture := workflow.ExecuteActivity(activityCtx, LongRunningActivity)
    timerFuture := workflow.NewTimer(ctx, 30*time.Second)
    signalCh := workflow.GetSignalChannel(ctx, "cancel-requested")

    var activityResult string
    var signalValue string
    selected := ""

    selector := workflow.NewSelector(ctx)
    selector.AddFuture(activityFuture, func(f workflow.Future) {
        if err := f.Get(ctx, &activityResult); err != nil {
            selected = "activity-error"
            return
        }
        selected = "activity-completed"
    })
    selector.AddFuture(timerFuture, func(workflow.Future) {
        selected = "timeout"
    })
    selector.AddReceive(signalCh, func(c workflow.ReceiveChannel, more bool) {
        if !more {
            selected = "signal-channel-closed"
            return
        }
        c.Receive(ctx, &signalValue)
        selected = "signal-received"
    })

    selector.Select(ctx)
    return selected, nil
}

func LongRunningActivity(ctx context.Context) (string, error) {
    return "done", nil
}

预期结果

text
activity-completed

这是片段示例:要运行它,还需要在同一个 Worker 中注册 WaitForFirstEvent Workflow 与 LongRunningActivity Activity,并由客户端启动 Workflow。若 Activity 在 30 秒内完成且没有先收到 Signal,Selector 会进入 Activity 分支;若 Timer 先就绪,则得到 timeout;若先收到 Signal,则进入 Signal 分支。

把超时、抢占和业务完成分开

Selector 最有价值的地方不是“语法更像 select”,而是把不同来源的业务事件表达成同一个 Workflow 控制点。可以把 Activity Future 看成“业务工作完成”,Timer 看成“时间条件满足”,Signal 看成“外部参与者要求改变方向”。

超时分支通常应该触发明确的业务动作,例如取消后续工作、记录超时状态或返回可重试结果。Signal 则更适合表示人工审批、取消、暂停等外部输入。不要把收到 Signal 与业务已经成功完成混为一谈,二者只是不同事件来源。

同一个 Selector 可以再次调用 Select。因此一个 Workflow 若需要持续处理多个 Signal,可以在循环中反复选择;如果某个 Future 只需要处理一次,通常在对应回调完成后退出等待逻辑即可。

多个事件同时就绪时怎么处理

不要把 Selector 当成“谁先写入内存谁一定先执行”的普通并发竞争器。SDK 的 Selector 约定允许在多个分支同时满足条件时选取其中一个分支,因此 Workflow 不能依赖这种情况下的偶然顺序。

例如 Activity Future 和 Timer 已经同时就绪时,业务代码不能假设一定先进入 Activity 分支。真正需要确定业务优先级时,应把优先级写成显式状态规则,而不是依赖 Selector 的选择结果。

一个常见做法是:Selector 只负责等待事件,回调只负责把事件转换成状态;随后由 Workflow 根据明确的业务规则决定是否继续、取消或结束。这样重放时不需要依赖 Go runtime 的随机调度。

检查每个分支是否可重放

为 Selector 添加分支时,可以逐个问三个问题:这个等待是否由 Temporal 管理;回调是否只修改 Workflow 状态;业务结果是否不依赖 wall-clock、随机数或非确定性的外部副作用。只要某个分支直接把不可重放的行为放进 Workflow,就可能在恢复或重放时产生不同结果。

实际设计中,Selector 最适合做“等待多个持久化事件并选择一个控制路径”,而不是把所有业务逻辑都塞进回调。保持分支短小、状态明确,并让 Activity 承担外部副作用,才能让多路事件控制流既清晰又可重放。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Selector 处理多路事件

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

登录哪都通