通过封装一个带有重试机制和超时控制的请求函数,在 fetch 调用后检查响应状态码和解析结果来实现健康检查。具体做法是定义一个包含最大重试次数、超时时间和目标 url 的配置对象,使用 promise 链或 async/await 处理异步逻辑,并在 catch 块中捕获网络错误或非 200 状态码,最终返回布尔值表示接口是否可用。

如何配置请求的超时与重试策略
通过设置 AbortController 实现超时控制,并在循环中处理重试逻辑。开发者需要创建一个控制器实例,将其 signal 传递给 fetch 选项,并设置定时器在指定毫秒后触发 abort。同时,利用 for 循环配合 try-catch 结构,当请求失败时等待短暂时间后重试,直到达到最大重试次数或成功。

const healthCheck = async (url, options = {}) => {
const { timeout = 5000, retries = 3 } = options;
let lastError;
for (let i = 0; i <= retries; i++) {
const controller = new AbortController();
const id = setTimeout(() => controller.abort(), timeout);
try {
const response = await fetch(url, {
method: 'GET',
signal: controller.signal
});
clearTimeout(id);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
return true;
} catch (error) {
clearTimeout(id);
lastError = error;
if (i === retries) break;
await new Promise(r => setTimeout(r, 1000 * (i + 1)));
}
}
console.error('Health check failed:', lastError.message);
return false;
};
// 使用示例
healthCheck('https://api.example.com/status', { timeout: 3000 }).then(res => {
console.log('API is healthy:', res);
});上述代码定义了 healthCheck 函数,接收目标 URL 和可选配置。默认超时为 5000 毫秒,重试 3 次。每次循环创建新的 AbortController,若超时则抛出 AbortError。若响应状态非 2xx,则抛出错误并进入下一次重试。所有重试失败后返回 false 并打印错误信息。
立即学习“Java免费学习笔记(深入)”;
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
如何处理不同 HTTP 状态码的错误分支
在请求过程中,需区分网络错误、超时错误和服务器返回的非成功状态码。通过检查 response.ok 属性判断 HTTP 状态是否在 200-299 之间,若不在则视为业务层面的不可用。对于网络断开或 DNS 解析失败等底层错误,直接捕获异常。这种分层处理确保能准确识别接口是暂时不可达还是主动拒绝服务。

const detailedHealthCheck = async (url) => {
try {
const response = await fetch(url, { method: 'HEAD' });
if (response.ok) return { status: 'healthy', code: response.status };
if (response.status === 429) return { status: 'rate_limited', code: response.status };
return { status: 'server_error', code: response.status };
} catch (error) {
if (error.name === 'AbortError') return { status: 'timeout', code: null };
return { status: 'network_error', code: null };
}
};
// 验证不同场景
Promise.all([
detailedHealthCheck('https://httpstat.us/200'),
detailedHealthCheck('https://httpstat.us/500'),
detailedHealthCheck('https://httpstat.us/429')
]).then(results => console.log(results));该函数使用 HEAD 方法减少数据传输,仅检查头部。若状态码为 429,返回限流状态;若为其他非 2xx,返回服务器错误。捕获块中通过 error.name 区分超时和网络错误。此逻辑覆盖了常见故障场景,便于前端监控面板展示具体故障类型。
基于程序中某个输入、条件或结果的具体问题
当目标接口返回非 JSON 内容或 CORS 策略限制时,Fetch API 的健康检查可能因解析失败或跨域拦截而误判。此时应仅依赖 HTTP 状态码和连接建立情况,避免尝试解析 body。若接口支持 OPTIONS 预检,可优先发送 OPTIONS 请求以验证 CORS 配置是否正确,从而更准确地反映接口的实际可用性。

















