服务注册与分布式协调 / 系统课时
配置 Parent Close Policy
配置 Parent Close Policy
Parent Close Policy 决定父 Workflow Run 进入关闭状态后,Temporal 应如何处理仍在运行的 Child Workflow。正确配置它,可以让“必须随父流程结束”“需要优雅取消”“应独立继续”的三类任务拥有清晰且可验证的生命周期。
学习目标
- 区分
TERMINATE、REQUEST_CANCEL与ABANDON的行为差异 - 在 TypeScript SDK 中为 Child Workflow 显式设置 Parent Close Policy
- 避免把“父流程结束”和“子流程取消完成”误认为同一件事
先按业务语义选择策略
Parent Close Policy 只控制父 Workflow 关闭之后对子 Workflow 的动作,不等同于普通的取消传播策略。默认策略是 TERMINATE,因此没有显式配置时,不应假设 Child 会独立运行。
| 策略 | 父 Workflow 关闭后 | 适合场景 | 关键风险 |
|---|---|---|---|
TERMINATE |
直接终止 Child | 子任务没有独立业务价值,必须与父流程同生共死 | 终止不是优雅取消,Child 没有继续执行清理逻辑的机会 |
REQUEST_CANCEL |
向 Child 发送取消请求 | Child 需要收到取消并自行收尾 | 取消是协作式的,Child 可能延迟响应或忽略取消 |
ABANDON |
不再干预 Child | Child 已取得独立业务责任,父流程结束后仍应继续 | 父流程不能再依赖“关闭即可停止 Child” |

选择策略时先问一个问题:父流程结束后,这个 Child 是否还拥有必须完成的业务责任? 如果没有,使用 TERMINATE 通常最简单;如果需要清理资源或补偿,使用 REQUEST_CANCEL;如果任务已经独立,例如异步生成报表或长时间批处理,则考虑 ABANDON。
在 Child Workflow 选项中显式配置
下面是 TypeScript SDK 的片段示例。它依赖 Worker 已注册 parentWorkflow 与 childWorkflow,重点是展示 startChild 与 parentClosePolicy 的组合。await startChild(...) 返回时,Child 已经成功启动,因此父流程随后返回时,ABANDON 才有一个真实存在的 Child 可以继续运行。
import {
ParentClosePolicy,
sleep,
startChild,
} from '@temporalio/workflow';
export async function childWorkflow(): Promise<string> {
await sleep('1 hour');
return 'child-completed';
}
export async function parentWorkflow(childId: string): Promise<string> {
const child = await startChild(childWorkflow, {
workflowId: childId,
parentClosePolicy: ParentClosePolicy.ABANDON,
});
// startChild 已确认 Child 启动;父 Workflow 此时可以安全结束。
return `started:${child.workflowId}`;
}这段配置生效后,父 Workflow 正常完成不会终止该 Child。若将策略改为 ParentClosePolicy.TERMINATE,父流程关闭时 Child 会被直接终止;改为 ParentClosePolicy.REQUEST_CANCEL,则 Temporal 会向 Child 请求取消,而不是强制立即停止。
验证父流程关闭后的 Child 状态
假设 Worker 监听 parent-close-demo Task Queue,并已注册上面的两个 Workflow。先执行父流程,再查询 Child:
temporal workflow execute \
--workflow-id parent-<ID> \
--type parentWorkflow \
--task-queue parent-close-demo \
--input '"child-<ID>"'
temporal workflow describe \
--workflow-id child-<ID>预期结果
父 Workflow 返回 started:child-<ID> 并进入 Completed。
Child Workflow 的状态仍为 Running,直到它自身完成、被取消、被终止或超时。
实际 Run ID、时间戳和状态展示格式可能不同。如果 Child 根本没有出现,优先检查 Worker 是否注册了 Child Workflow、Task Queue 是否一致,以及父流程是否真正等待到 Child 启动成功。对于“发起后立即结束”的异步模式,先确认 Child 已启动,再让父流程结束是 ABANDON 能可靠工作的前提。
把策略固化为业务约束
生产代码不要在多个调用点随意选择策略。更稳妥的做法是把策略和业务类型绑定:订单内步骤使用 TERMINATE,需要补偿清理的长任务使用 REQUEST_CANCEL,真正独立的后台任务才允许 ABANDON。这样评审代码时看到 Parent Close Policy,就能直接判断父子生命周期是否符合业务责任边界。