服务注册与分布式协调 / 系统课时

配置 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”

父 Workflow 关闭后对 Child Workflow 的三种生命周期策略

选择策略时先问一个问题:父流程结束后,这个 Child 是否还拥有必须完成的业务责任? 如果没有,使用 TERMINATE 通常最简单;如果需要清理资源或补偿,使用 REQUEST_CANCEL;如果任务已经独立,例如异步生成报表或长时间批处理,则考虑 ABANDON。

在 Child Workflow 选项中显式配置

下面是 TypeScript SDK 的片段示例。它依赖 Worker 已注册 parentWorkflow 与 childWorkflow,重点是展示 startChild 与 parentClosePolicy 的组合。await startChild(...) 返回时,Child 已经成功启动,因此父流程随后返回时,ABANDON 才有一个真实存在的 Child 可以继续运行。

typescript
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:

bash
temporal workflow execute \
  --workflow-id parent-<ID> \
  --type parentWorkflow \
  --task-queue parent-close-demo \
  --input '"child-<ID>"'

temporal workflow describe \
  --workflow-id child-<ID>

预期结果

text
父 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,就能直接判断父子生命周期是否符合业务责任边界。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置 Parent Close Policy

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通