服务注册与分布式协调 / 系统课时
理解 Workflow Execution 身份与生命周期
理解 Workflow Execution 身份与生命周期
这一课解决 Temporal 中最容易混淆的四个身份:Namespace、Workflow ID、Run ID 和 Workflow Execution。理解它们之后,你就能准确判断一次工作流究竟是谁、当前跑的是哪一轮,以及关闭后为什么还可能出现新的 Run。
学习目标
- 区分 Namespace、Workflow ID、Run ID 与 Workflow Execution 的职责
- 理解 Workflow Execution 从启动到关闭的主要状态变化
- 能解释同一个 Workflow ID 为什么可以对应多个 Run
先建立四层身份模型
可以把一次 Temporal 工作流理解成“业务对象 + 一次具体执行”。Namespace 提供隔离边界,Workflow ID 通常承载业务上稳定的身份,Run ID 则标识某一次具体执行。Workflow Execution 是这次具体运行及其历史的整体实体。

Namespace 首先解决的是隔离,而不是某一次运行的唯一性。可以把它看成 Temporal 中的一块逻辑空间;相同的 Workflow ID 放在不同 Namespace 中,并不表示同一个执行。
Workflow ID 更适合作为业务稳定键。例如订单流程可以使用 order-10086,用户注册流程可以使用 user-42-signup。只要你的业务希望持续追踪“这个对象对应的工作流”,就应该让 Workflow ID 保持稳定、有意义。
Run ID 是 Temporal 为某次具体执行实例分配的唯一标识。一次执行结束后,另一次新的执行可以拥有相同的 Workflow ID,但必须通过新的 Run ID 与前一次区分。因此,排查历史事件、定位具体运行时,Run ID 往往比 Workflow ID 更精确。
Workflow Execution 可以直接理解成“某个 Workflow ID 的一次具体运行”。因此定位一条执行记录时,可以按照 Namespace + Workflow ID + Run ID 来建立完整上下文,而不要只看到 Workflow ID 就认为那已经唯一。
从启动到关闭发生了什么
Workflow Execution 启动后进入运行阶段,Temporal 持续记录能够用于恢复和重放的执行历史。业务代码不应把它理解成一个必须长期占用某台服务器进程的普通函数;Worker 可以发生重启,执行仍然能够依据持久化状态继续推进。
正常结束时,当前 Run 会进入关闭状态。关闭原因可能是成功完成,也可能是失败、取消、终止或超时等。这里的关键是:Run 的关闭并不等于 Workflow ID 永远消失。
尤其要注意 Continue-As-New。它会结束当前 Run,并以相同的 Workflow ID 创建新的 Run,同时从新的历史开始继续工作。这样可以控制长期工作流的历史规模,却仍然保持同一个业务身份。
可以用下面的关系记忆:
| 标识 | 主要作用 | 是否随新 Run 改变 |
|---|---|---|
| Namespace | 逻辑隔离与组织 | 否,除非重新启动到其他 Namespace |
| Workflow ID | 稳定的业务身份 | 否 |
| Run ID | 某一次具体执行的身份 | 是 |
| Workflow Execution | 一次具体运行及其历史 | 每个 Run 对应一次 |
同一个 Workflow ID 为什么会出现多个 Run
最常见的原因有两类:工作流重新启动产生新的执行,或者当前 Run 使用 Continue-As-New 进入下一轮。两种情况都可能让你看到相同的 Workflow ID 配合不同的 Run ID。
这意味着监控和业务系统不要简单地把“Workflow ID 改变”当成流程换了一个业务对象。对于一个长期业务流程,Workflow ID 往往保持稳定,而 Run ID 只是当前执行轮次。
排障时也不要只记录 Workflow ID。日志、告警、人工操作最好同时保留 Namespace、Workflow ID 和 Run ID;这样既能快速定位业务流程,也能精确落到某一次运行历史。
生命周期判断的关键边界
看到一个关闭的 Run 时,先判断关闭原因,再决定它代表什么。正常完成表示流程已经结束;失败、取消、终止或超时说明当前 Run 没有以成功状态收尾;而 Continue-As-New 则意味着当前 Run 结束后,逻辑工作流仍可能在新的 Run 中继续。
因此,**Workflow ID 更像“我在追踪谁”,Run ID 更像“我正在查看哪一轮”,Workflow Execution 则是“这一轮具体发生了什么”。**掌握这三个层次后,后续的重试、信号、查询和 Continue-As-New 才能准确落到对应对象上。