服务注册与分布式协调 / 系统课时
使用 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 会挂起;有分支就绪后,则执行一个匹配分支的回调。

用一个 Workflow 同时等待三路事件
下面的片段示范一个常见模式:启动一个 Activity 得到 Future,同时创建超时 Timer,再监听 cancel-requested Signal。哪个事件先完成,就先处理哪个结果。
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
}预期结果
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 承担外部副作用,才能让多路事件控制流既清晰又可重放。