服务注册与分布式协调 / 系统课时
认识 Client、Server、Worker 与 Task Queue
认识 Client、Server、Worker 与 Task Queue
这一课解决 Temporal 四个核心角色的职责边界:谁发起请求、谁保存执行事实、谁分发任务、谁真正运行代码。理解这条通信链后,就能正确判断启动、恢复、扩容和排障时各组件应承担的责任。
学习目标
- 说清 Client、Temporal Server、Worker 与 Task Queue 的职责边界
- 跟踪一次 Workflow 启动后,Workflow Task 与 Activity Task 如何被分发和处理
- 判断常见架构误解,例如“Client 直接调用 Worker”或“Task Queue 保存 Workflow 状态”
四个角色各自负责什么
Client 是应用访问 Temporal 的入口。它通过 SDK 调用 Temporal Server,用于启动 Workflow、发送 Signal 或 Update、发起 Query、取消执行以及读取结果。Client 不需要知道某个 Worker 实例的地址,也不会把业务任务直接推给 Worker。
Temporal Server 是可靠执行的控制平面。它接收 Client 与 Worker 的请求,维护 Workflow Execution 的 Event History 和执行元数据,并根据历史中的事件推进后续调度。Server 负责持久化与协调,但不会加载并执行你的 Workflow 或 Activity 业务代码。
Worker 是运行应用代码的进程。Worker 启动后向指定 Task Queue 进行长轮询,拿到 Workflow Task、Activity Task 等任务后,在本地执行已经注册的 Workflow 或 Activity 代码,再把命令或执行结果返回给 Server。
Task Queue 是 Server 侧的轻量级动态任务队列,用名字连接“要处理的任务”和“能够处理这些任务的 Worker”。它承担路由和负载分发,不是 Workflow 业务状态的权威存储,也不是让 Client 与 Worker 直接通信的通道。
| 角色 | 主要职责 | 不负责什么 |
|---|---|---|
| Client | 向 Server 发起控制与查询请求 | 不直接选择具体 Worker 实例 |
| Server | 持久化执行事实、生成并协调任务 | 不执行用户业务代码 |
| Task Queue | 把待处理 Task 路由给轮询它的 Worker | 不保存完整 Workflow 状态 |
| Worker | 轮询 Task Queue 并执行应用代码 | 不成为 Workflow 状态的唯一持有者 |
一次启动如何穿过系统
启动 Workflow 时,Client 先把 Workflow Type、Workflow ID、Task Queue 和输入提交给 Server。Server 创建执行并记录事件,然后把需要推进 Workflow 的 Workflow Task 放到对应 Task Queue。某个 Worker 长轮询拿到任务后执行 Workflow 代码,根据结果生成命令,例如安排 Activity、创建 Timer 或完成 Workflow,再把这些命令交回 Server。
如果 Workflow 安排了 Activity,Server 会记录这一决定并产生 Activity Task。轮询相应 Task Queue 的 Worker 执行 Activity 后,把完成结果或失败返回 Server;Server 再记录事件并安排新的 Workflow Task,让 Workflow 代码基于新增历史继续推进。整个过程中,Worker 可以重启或横向扩容,因为执行事实保存在 Server 管理的持久化状态中。

下面是片段示例,依赖已经创建的 Go SDK client.Client、context.Context,以及 Worker 中已注册的 OrderWorkflow。它不是独立可运行程序,只用于观察一次启动请求里 Workflow ID 与 Task Queue 的位置。
// Workflow ID 表达业务身份;TaskQueue 决定任务路由到哪组轮询者。
run, err := temporalClient.ExecuteWorkflow(
ctx,
client.StartWorkflowOptions{
ID: "order-123",
TaskQueue: "order-processing",
},
OrderWorkflow,
"order-123",
)
if err != nil {
return err
}
// Run ID 由 Server 为这一次运行分配。
fmt.Println(run.GetID(), run.GetRunID())这段调用只把启动意图发送给 Server。TaskQueue: "order-processing" 表示后续 Workflow Task 应路由到哪一组轮询者,并不表示 Client 已经选中了某个 Worker。只要兼容的 Worker 轮询同名 Task Queue,就可以竞争领取任务。
Task Queue 不是传统消息队列替身
把 Task Queue 当成 Kafka 或 RabbitMQ 的业务消息主题,会造成错误设计。Temporal 的 Task 是 Server 为推进 Workflow Execution 生成的内部工作单元;应用真正需要长期可靠保存的执行事实进入 Event History,而不是由业务代码自己消费一条消息后手工维护状态机。
同一个 Task Queue 可以由多个 Worker 共同轮询,从而横向扩展处理能力。反过来,如果没有兼容 Worker 轮询某个 Task Queue,任务会等待,Workflow 也不会凭空在 Server 上执行。排查“Workflow 一直不动”时,因此既要看执行历史,也要确认目标 Task Queue 是否有正确的 Worker 在轮询。
用通信方向快速判断职责
遇到 Temporal 架构问题时,可以先按通信方向判断:Client 面向 Server 发起控制请求,Server 根据持久化历史生成 Task,Worker 主动从 Task Queue 拉取 Task,再把命令或结果交回 Server。只要记住“Server 保证执行事实,Worker 提供计算能力,Task Queue 连接二者”,大多数职责边界就不会混淆。