服务注册与分布式协调 / 系统课时
传播取消并清理外部操作
传播取消并清理外部操作
本课解决 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 代码主动把取消信号传给具体资源。

让可取消 I/O 真正停止
下面是一个 Activity 片段示例。它把 Temporal 提供的 AbortSignal 传给支持 signal 的 HTTP 客户端,并用 finally 确保本地清理始终执行。示例依赖 Node.js fetch 以及 Temporal TypeScript Activity 上下文。
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();
}
}预期结果
正常完成:返回临时文件路径并执行清理逻辑。
收到取消:fetch 在支持 AbortSignal 的情况下被中止,随后进入 finally 执行资源清理。这里的关键不是 finally 本身,而是取消信号必须进入真正执行 I/O 的位置。如果 HTTP、数据库驱动或 SDK 不支持取消,就需要查清它的中止 API;否则 Activity 即使已经收到取消,也可能继续占用线程、连接或外部配额。
心跳让长任务能感知取消
对于几十秒到数分钟甚至更久的 Activity,建议把 heartbeat 放在稳定的进度边界上,例如每处理一个批次就发送一次,而不是机械地在循环里高频调用。Heartbeat 还能携带恢复所需的进度信息,但不要把大型业务对象直接塞进去。
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;
}预期结果
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 已失效、外部操作还在继续」的资源泄漏或业务不一致。