网络请求失败时应使用支持指数退避、最大重试次数和错误过滤的retryAsync函数。该函数基于Promise递归实现,可配置baseDelay、maxRetries、shouldRetry及AbortController信号,兼容async/await语法,提升健壮性与可维护性。

网络请求失败时,简单重试几次往往比立刻报错更实用。Promise 本身不带重试逻辑,但可以轻松封装一个支持指数退避、最大重试次数和错误过滤的重试函数。
基础重试:用 Promise 链实现简单循环
核心思路是用递归或循环调用 fetch(或其他请求方法),捕获 reject 后判断是否继续重试。
示例代码:
function retry(fn, times = 3) {
return fn().catch(err => {
if (times <= 1) throw err;
return new Promise(resolve => setTimeout(() => resolve(), 1000))
.then(() => retry(fn, times - 1));
});
}
<p>// 使用
retry(() => fetch('/api/data'))
.then(res => res.json())
.catch(err => console.error('最终失败:', err));</p>这个版本每次等待 1 秒,固定延迟,适合调试或低频场景。
立即学习“Java免费学习笔记(深入)”;
增强版:指数退避 + 可配置参数
真实网络波动常需逐渐拉长等待时间,避免雪崩式重试。同时应支持跳过某些错误(如 401、404)不重试。
关键点:
- 延迟时间按 2ⁿ 毫秒增长(如第1次 500ms,第2次 1000ms,第3次 2000ms)
- 允许传入自定义判断函数,决定某次错误是否值得重试
- 超时控制可与 AbortController 结合,防止单次请求卡死
生产可用:封装成可复用工具函数
下面是一个兼顾健壮性与易用性的 retry 工具:
function retryAsync(fn, options = {}) {
const {
maxRetries = 3,
baseDelay = 500,
shouldRetry = (err) => err instanceof TypeError || /network|fetch/i.test(err.message),
signal
} = options;
<p>const attempt = (n) => {
return fn().catch(async (err) => {
if (n >= maxRetries || !shouldRetry(err)) throw err;
if (signal?.aborted) throw new Error('Retry aborted');</p><pre class='brush:php;toolbar:false;'> const delay = baseDelay * Math.pow(2, n);
await new Promise(r => setTimeout(r, delay));
return attempt(n + 1);
});};
return attempt(0); }
使用示例:
const controller = new AbortController();
setTimeout(() => controller.abort(), 10000); // 总超时 10 秒
<p>retryAsync(
() => fetch('/api/orders', { signal: controller.signal }),
{
maxRetries: 4,
baseDelay: 300,
shouldRetry: (err) =>
err.name === 'TypeError' || // 网络断开
(err.response?.status >= 500) // 服务端错误才重试
}
)
.then(res => res.json())
.catch(err => {
if (err.name === 'AbortError') console.log('请求被取消');
else console.error('重试耗尽', err);
});</p>配合 async/await 更自然地使用
现代写法中,直接在 async 函数里调用 retryAsync,语义清晰,错误处理也直观:
示例:
async function loadData() {
try {
const res = await retryAsync(
() => fetch('/api/user'),
{ maxRetries: 2 }
);
return await res.json();
} catch (err) {
throw new Error(`加载用户失败:${err.message}`);
}
}
这样既保持了异步流程的线性阅读感,又把重试细节完全隔离在外。










