在async函数中实现请求超时控制，推荐使用AbortController结合setTimeout，既能真正取消网络请求、释放连接，又语义清晰；若仅用Promise.race+setTimeout则无法终止实际请求，存在资源浪费风险。
在 async 函数中实现带超时的请求控制，核心思路是：用 Promise.race() 并发竞争“成功响应”和“超时拒绝”，让先完成者决定最终结果。
用 Promise.race + setTimeout 实现基础超时
这是最常用、兼容性好、不依赖外部库的方式。关键在于构造一个在指定时间后自动 reject 的 Promise，并与 fetch（或其他异步操作）一起 race：
- 创建一个超时 Promise：
new Promise((_, reject) => setTimeout(() => reject(new Error('Request timeout')), ms)) - 将它与请求 Promise 一起传入
Promise.race([fetch(...), timeoutPromise]) - await race 结果，若超时则抛出错误，可被 try/catch 捕获
示例：
async function fetchWithTimeout(url, timeout = 5000) {
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), timeout);
try {
const response = await fetch(url, {
signal: controller.signal
});
clearTimeout(timeoutId);
return response;
} catch (err) {
clearTimeout(timeoutId);
if (err.name === 'AbortError') {
throw new Error('Request timeout');
}
throw err;
}
}
推荐：结合 AbortController（现代且更健壮）
Fetch 原生支持 AbortController，它不仅能中断网络请求（避免资源浪费），还能与超时逻辑自然融合，比纯 setTimeout 更可靠：
立即学习“Java免费学习笔记（深入）”；
- 创建
AbortController实例 - 用
setTimeout触发controller.abort() - 将
controller.signal传给fetch - 捕获
AbortError并统一转为超时错误
优势：真正取消请求、释放连接；兼容 streaming 和大型响应；语义清晰。
封装成可复用的工具函数
把超时逻辑抽离成高阶函数，提升复用性：
function withTimeout(promise, ms) {
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), ms);
return Promise.race([
promise,
new Promise((_, reject) =>
setTimeout(() => reject(new Error('Operation timeout')), ms)
)
]).finally(() => clearTimeout(timeoutId));
}
// 使用示例
async function getData() {
try {
const res = await withTimeout(fetch('/api/data'), 3000);
return await res.json();
} catch (err) {
console.error(err.message); // "Operation timeout" 或其他错误
}
}
注意：此版本未传递 signal，适合非 fetch 场景（如等待某个自定义 Promise）。若用于 fetch，仍建议优先用上一节的 AbortController 方式。
注意事项与常见陷阱
-
不要只靠 setTimeout reject：仅用
Promise.race([fetch(), timeoutPromise])无法终止实际的网络请求，fetch 仍在后台运行，可能造成内存泄漏或重复处理 -
清除定时器：无论成功或失败，都要调用
clearTimeout，避免意外触发 - 区分错误类型：超时错误应明确标识（如自定义 error name 或 code），便于上层做差异化处理（比如重试、降级）
-
Node.js 环境：若用
node-fetch或axios，同样支持signal；axios 还提供timeout配置项（但它是底层 socket 超时，语义略有不同）
