服务注册与分布式协调 / 系统课时
实现并注册 Activity 与 Worker
实现并注册 Activity 与 Worker
这一节把一个会读取本地文件的 I/O 操作放进 Activity,并用 Go Worker 注册 Workflow 与 Activity。完成后,你会得到一个能连接本地 Temporal Service、监听指定 Task Queue 并等待领取任务的最小 Worker。
学习目标
- 判断哪些外部 I/O 必须从 Workflow 移到 Activity。
- 使用 Go SDK 注册 Workflow、Activity,并启动 Worker。
- 说明 Worker、Task Queue 与任务领取之间的关系。
把外部 I/O 放进 Activity
Workflow 代码会在故障恢复和任务重放时再次执行,因此它必须保持确定性。读取文件、访问数据库、发 HTTP 请求这类操作依赖进程外部状态,结果可能随时间变化,应放进 Activity;Workflow 只负责决定“何时执行 Activity、等待什么结果、下一步做什么”。
下面的示例让 ReadMessage 读取文件,而 FileWorkflow 仅通过 workflow.ExecuteActivity 调用它。Activity 失败时,错误会返回给 Temporal,后续是否重试由 Activity 的重试与超时策略决定。
实现可运行的 Worker
前置条件是本机已有 Temporal Service 监听 localhost:7233,并且当前目录可以创建 Go Module。先初始化依赖:
go mod init temporal-worker-demo
go get go.temporal.io/sdk@latest预期结果:目录中生成 go.mod 和 go.sum,go.mod 记录 go.temporal.io/sdk 依赖;具体下载日志与版本号可能不同。
创建 main.go:
package main
import (
"context"
"fmt"
"log"
"os"
"strings"
"time"
"go.temporal.io/sdk/activity"
"go.temporal.io/sdk/client"
"go.temporal.io/sdk/worker"
"go.temporal.io/sdk/workflow"
)
const taskQueue = "file-io"
func ReadMessage(ctx context.Context, path string) (string, error) {
data, err := os.ReadFile(path)
if err != nil {
return "", fmt.Errorf("read %s: %w", path, err)
}
activity.GetLogger(ctx).Info("message loaded", "path", path, "bytes", len(data))
return strings.TrimSpace(string(data)), nil
}
func FileWorkflow(ctx workflow.Context, path string) (string, error) {
ctx = workflow.WithActivityOptions(ctx, workflow.ActivityOptions{
StartToCloseTimeout: 10 * time.Second,
ScheduleToCloseTimeout: 30 * time.Second,
})
var result string
err := workflow.ExecuteActivity(ctx, ReadMessage, path).Get(ctx, &result)
return result, err
}
func main() {
c, err := client.Dial(client.Options{
HostPort: client.DefaultHostPort,
Namespace: client.DefaultNamespace,
})
if err != nil {
log.Fatal(err)
}
defer c.Close()
w := worker.New(c, taskQueue, worker.Options{})
w.RegisterWorkflow(FileWorkflow)
w.RegisterActivity(ReadMessage)
log.Printf("worker ready: task_queue=%s workflow=FileWorkflow activity=ReadMessage", taskQueue)
if err := w.Run(worker.InterruptCh()); err != nil {
log.Fatal(err)
}
}这里必须先调用 RegisterWorkflow 和 RegisterActivity,再执行 w.Run。注册动作建立的是 Worker 进程内的类型映射;真正的 Workflow Execution 与 Activity Execution 仍由 Temporal Service 创建和调度。
运行 Worker:
go run .预期输出:
<TIME> worker ready: task_queue=file-io workflow=FileWorkflow activity=ReadMessage进程随后保持运行并持续轮询 Task Queue;<TIME> 会随实际运行时间变化。
Worker 如何通过 Task Queue 领取任务
Temporal Service 把待执行的 Workflow Task 或 Activity Task 放到命名 Task Queue。Worker 对 file-io 做长轮询;拿到 Workflow Task 后执行已注册的 FileWorkflow,Workflow 再调度 ReadMessage Activity;对应 Activity Task 被领取后,Worker 才真正访问文件系统。

Task Queue 负责把任务路由给合适的 Worker,但它不是业务消息队列。多个 Worker 可以监听同一个队列来水平扩展;如果启动 Workflow 时填写了不同的 Task Queue,即使代码已注册,当前 Worker 也不会收到那次执行的任务。
注册失败时先检查什么
如果 Worker 启动后一直没有执行,先核对启动 Workflow 使用的 Task Queue 是否与 file-io 完全一致。若队列一致但类型未注册,Worker 无法按类型名找到对应 Workflow 或 Activity,任务会失败或继续重试,而不是自动调用一个“名字相近”的函数。
Activity 中可以进行外部 I/O,Workflow 中则只保留可重放的编排逻辑。把这个边界守住,再确保“注册类型”和“监听队列”同时匹配,Worker 才能稳定领取并执行 Temporal 任务。