服务注册与分布式协调 / 系统课时
使用 Child Workflow 拆分长流程
使用 Child Workflow 拆分长流程
本课解决一个常见建模问题:一个 Workflow 越写越长,既包含主流程,又夹着可独立运行的子流程。通过 Child Workflow 可以把子流程拆成独立执行单元,同时保留父子关系、结果等待、取消和生命周期策略。
学习目标
- 能判断什么时候应该把一段长流程拆成 Child Workflow
- 能使用 TypeScript SDK 启动子工作流并等待结果
- 能理解父流程关闭、取消传播与子流程结果之间的关系
什么时候值得拆成 Child Workflow
Child Workflow 是“从一个 Workflow Execution 内启动另一个 Workflow Execution”。与普通函数调用不同,子流程有自己的 Workflow Execution 和事件历史;启动、开始、完成等 Child Workflow 事件会记录在父 Workflow 的 Event History 中,因此 Temporal 能在重放时保留父子执行关系。:contentReference[oaicite:6]{index=6}
适合拆分的通常是边界清晰、可能持续较久、需要独立重试或希望独立观察的子流程。例如订单主流程负责协调,而“人工审批”“文件处理”“供应商履约”各自形成 Child Workflow。反过来,如果只是三五行纯计算,把它拆成 Child Workflow 只会增加执行边界和历史复杂度。

用 executeChild 建立最小拆分
TypeScript SDK 提供 executeChild() 直接启动 Child Workflow 并等待其完成;默认情况下 Child Workflow 使用与 Parent 相同的 Task Queue。调用返回后,父 Workflow 可以继续使用子流程结果。:contentReference[oaicite:7]{index=7}
下面是一个最小主示例。parentWorkflow 负责总体编排,invoiceWorkflow 只负责生成发票编号。
import { executeChild } from '@temporalio/workflow';
export async function invoiceWorkflow(orderId: string): Promise<string> {
return `invoice-${orderId}`;
}
export async function orderWorkflow(orderId: string): Promise<string> {
const invoiceId = await executeChild(invoiceWorkflow, {
workflowId: `invoice-${orderId}`,
args: [orderId],
});
return `order=${orderId}; invoice=${invoiceId}`;
}预期结果
order=ORDER-123; invoice=invoice-ORDER-123这里的 workflowId 应尽量具有业务含义,并与业务实体的唯一性约束一致。例如订单只允许存在一个“开票子流程”时,可以让子 Workflow ID 与订单 ID 建立确定关系。代码示例中的 ORDER-123 只是演示值,实际业务应使用真实订单标识。
等待结果还是拿句柄
如果父流程必须等子流程完成才能继续,用 executeChild() 最直接;如果父流程需要先启动子流程,然后执行其他步骤、发送 Signal 或在稍后获取结果,可以使用 startChild() 拿到 Child Workflow Handle。Temporal TypeScript SDK 对两者的语义定义很明确:executeChild() 等待完成,startChild() 返回句柄。:contentReference[oaicite:8]{index=8}
import { startChild } from '@temporalio/workflow';
export async function parentWorkflow(orderId: string): Promise<string> {
const child = await startChild(invoiceWorkflow, {
workflowId: `invoice-${orderId}`,
args: [orderId],
});
// 这里可以先做其他 Workflow 内部编排,再等待子流程结果。
const invoiceId = await child.result();
return `invoice=${invoiceId}`;
}
export async function invoiceWorkflow(orderId: string): Promise<string> {
return `invoice-${orderId}`;
}预期结果
invoice=invoice-ORDER-123无论使用哪一种 API,都不要把“启动子流程”理解成普通异步函数调用。Temporal 会记录 Child Workflow 的启动与完成事件,而且 TypeScript SDK 在 startChild() 或 executeChild() 解析之前会等待 ChildWorkflowExecutionStarted 事件,确保子流程已经真正启动。:contentReference[oaicite:9]{index=9}
处理取消与父流程关闭
Child Workflow 有两个很容易混淆的生命周期问题。第一是取消:子 Workflow 可以受所在 Cancellation Scope 影响;第二是父流程关闭:Parent Close Policy 决定父 Workflow 已经 Completed、Failed 或 Timed Out 后,子 Workflow 怎么处理。
TypeScript SDK 中,parentClosePolicy 是 Child Workflow 专属选项之一,默认策略是终止 Child Workflow。也就是说,不能因为“子流程被拆出来了”就假设它一定会脱离父流程继续运行。需要独立存活的设计必须显式选择合适的 Parent Close Policy。:contentReference[oaicite:10]{index=10}
另外,如果 Child Workflow 是在 Signal 或 Update Handler 等非主执行上下文中启动,要确保 Parent 在启动调用完成前不会结束;官方文档特别指出,否则可能出现父流程已经关闭而子流程尚未确认启动的情况。:contentReference[oaicite:11]{index=11}
用拆分边界控制历史与责任
拆 Child Workflow 的真正价值,不是减少代码行数,而是建立执行责任边界。父 Workflow 保留主业务状态与编排决策;子 Workflow 负责一个可以独立描述、观察和失败处理的长任务。这样做之后,父流程等待的是“子流程结果”,而不是手工管理一堆长时间异步状态。
一个实用判断标准是:这段逻辑是否拥有自己的生命周期、是否可能持续很久、是否需要单独取消或观察、是否有明确的输入输出。如果四项里大部分都成立,Child Workflow 通常比普通 Activity 或函数更合适;如果只是短小步骤或一次外部调用,则保持在当前 Workflow 中往往更简单。:contentReference[oaicite:12]{index=12}