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

传播取消并清理外部操作

传播取消并清理外部操作

本课解决 Workflow 已经取消,但 Activity 里的 HTTP、文件、数据库或云资源操作仍继续运行的问题。你会建立「取消请求 → Activity 收到信号 → 中止可取消 I/O → finally 清理 → 必要时补偿」的完整生命周期。

学习目标

  • 理解 Workflow 取消如何传递到正在运行的 Activity
  • 使用 AbortSignal 或取消感知等待让外部 I/O 真正停止
  • 在 finally 中释放连接、临时文件和锁,并区分清理与业务补偿

取消不会自动停止所有外部副作用

Temporal 可以向正在执行的 Activity 传递取消请求,但 Activity 必须能够观察并处理这个取消。TypeScript SDK 中,Activity 可以等待 Context.current().cancelled,使用可被取消的 sleep,或者把 Context.current().cancellationSignal 作为 AbortSignal 传给支持取消的库。对于正在运行的 Activity,取消通知通常通过 heartbeat 到达;不发送 heartbeat 时,取消感知可能被延迟。:contentReference[oaicite:3]{index=3}

因此,「Workflow 已取消」和「外部 HTTP 已断开」不是同一件事。前者改变 Temporal 中的执行状态,后者需要你的 Activity 代码主动把取消信号传给具体资源。

Workflow 取消传播与外部资源清理生命周期

让可取消 I/O 真正停止

下面是一个 Activity 片段示例。它把 Temporal 提供的 AbortSignal 传给支持 signal 的 HTTP 客户端,并用 finally 确保本地清理始终执行。示例依赖 Node.js fetch 以及 Temporal TypeScript Activity 上下文。

ts
import { Context } from '@temporalio/activity';

export async function downloadReport(url: string): Promise<string> {
  const signal = Context.current().cancellationSignal;
  const tempFile = `/tmp/report-${Date.now()}.tmp`;

  try {
    const response = await fetch(url, { signal });
    if (!response.ok) {
      throw new Error(`HTTP ${response.status}`);
    }

    const body = await response.text();
    await writeTemporaryFile(tempFile, body);
    return tempFile;
  } finally {
    // 无论正常完成还是取消,都释放本地临时资源。
    await closeOpenHandles();
  }
}

预期结果

text
正常完成:返回临时文件路径并执行清理逻辑。
收到取消:fetch 在支持 AbortSignal 的情况下被中止,随后进入 finally 执行资源清理。

这里的关键不是 finally 本身,而是取消信号必须进入真正执行 I/O 的位置。如果 HTTP、数据库驱动或 SDK 不支持取消,就需要查清它的中止 API;否则 Activity 即使已经收到取消,也可能继续占用线程、连接或外部配额。

心跳让长任务能感知取消

对于几十秒到数分钟甚至更久的 Activity,建议把 heartbeat 放在稳定的进度边界上,例如每处理一个批次就发送一次,而不是机械地在循环里高频调用。Heartbeat 还能携带恢复所需的进度信息,但不要把大型业务对象直接塞进去。

ts
import { Context, heartbeat } from '@temporalio/activity';

export async function processBatches(ids: string[]): Promise<number> {
  const signal = Context.current().cancellationSignal;
  let completed = 0;

  for (const id of ids) {
    await processOne(id, signal);
    completed += 1;
    heartbeat({ completed });
  }

  return completed;
}

预期结果

text
Activity 每完成一个 ID 就发送一次 heartbeat;取消请求到达后,支持 AbortSignal 的 processOne 可以终止当前 I/O,Activity 随后退出并执行调用方定义的清理逻辑。

这类设计尤其适合文件上传、分页同步和批量 API 调用。取消粒度取决于单个批次的持续时间:一个批次运行十分钟,即使每批完成后才 heartbeat,也意味着取消可能要等很久才能在当前操作边界被观察到。

清理和补偿要分开

清理解决的是「资源必须释放」:关闭连接、删除临时文件、释放锁、停止本地定时器。这类动作通常放在 finally,因为无论成功、失败还是取消,都应该尝试执行。

补偿解决的是「业务副作用已经发生,如何恢复」。例如支付已经扣款但 Workflow 后续取消,不能把退款简单地当作 Activity 的普通 finally 清理;应该由 Workflow 的业务逻辑决定是否需要安排补偿,并考虑幂等性和重试。

验证取消链路是否完整

真正上线前,至少验证一次「取消发生在外部 I/O 中间」的场景,而不是只测试 Activity 已经完成后的取消。观察四个位置:Workflow 状态是否变为取消、Activity 是否收到取消、外部 I/O 是否停止、清理代码是否执行。

最终的可靠取消不是某一个 API 调用,而是一条完整链路:Temporal 负责传播取消意图,Activity 负责观察取消,底层 I/O 负责真正中止,finally 负责释放资源,业务层则负责决定是否需要补偿。只缺其中一环,任务仍可能出现「Workflow 已失效、外部操作还在继续」的资源泄漏或业务不一致。

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

目录与阅读设置

阅读设置

17

记录一个想法

传播取消并清理外部操作

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

登录哪都通