如何实现支持自动重试的异步函数包装器

在异步编程中，重试机制是提升系统韧性的常见手段。其核心思路并不复杂：借助一个高阶函数封装异步操作，自动融入重试次数、延迟策略、错误过滤等控制逻辑。最底层的实现无非是 await 配合 for 循环来管理尝试次数，每次失败后按预定策略等待一段时间再试。

支持最大重试次数与基础延迟

先看最实用的简化版本：它需要两个参数——最大尝试次数（maxRetries）和初始延迟（baseDelayMs）。每次失败后，递增等待时长，例如采用指数退避策略，避免高频重试瞬间压垮目标服务。具体操作上：

• 每次执行前检查是否已达上限，若是则直接抛出最后一次错误
• 捕获异常后，用 await new Promise(r => setTimeout(r, delay)) 实现等待
• 延迟可以固定，但更推荐按重试次数指数增长：baseDelayMs * 2 ** attempt

允许跳过特定错误类型

并非所有错误都值得重试。典型场景如 401（未授权）、404（资源不存在）或业务校验失败，此时应立即终止重试。因此，包装器需要接收一个 shouldRetry 函数，它接收错误对象，返回 true 表示值得继续尝试，返回 false 则立即 throw error。常见的判断逻辑包括检查 error.status、error.code 或 error.message，是否匹配可恢复的错误类型（如网络超时、502/503/504）。

保留原始函数签名与上下文

包装器不应侵入业务逻辑，对调用者而言应保持透明——调用方式与原函数完全一致。借助 TypeScript 泛型，可以自然推导出参数类型与返回值类型，例如 async function retry(fn: (...args: any[]) => Promise, ...)。内部通过 fn.apply(thisArg, args) 保证 this 和参数的透传，这一点尤为关键——它能兼容对象方法调用。最终，返回一个全新函数，调用时自动进入带重试的执行流程。

可选：支持取消与超时控制

长时间的重试可能阻塞用户操作，因此有必要集成 AbortSignal 或自定义的 timeout 机制。具体来说，可传入 signal，在每次 await 前检查 signal.aborted，提前退出；传入 timeoutMs 时，记录起始时间，每次循环检查总耗时，超时立即抛出 TimeoutError。需要留意的是，AbortSignal 只有配合支持它的异步操作（如 fetch(signal)）才能发挥完整作用，否则它仅用于控制重试流程本身的取消。