通过封装一个统一的请求函数,在 fetch 调用后拦截响应并统一处理状态码与解析逻辑,即可实现接口请求结果的标准化。具体做法是定义一个返回标准结构(如包含 success、data、error)的函数,内部根据 http 状态码和 json 解析结果进行分支判断,确保无论成功或失败,调用方都能以一致的方式获取数据。

fetch 请求中如何区分网络错误与业务错误
在封装函数中,利用 response.ok 属性判断 HTTP 状态码是否在 200-299 之间,若为 false 则直接抛出包含状态码的错误对象;若为 true 则尝试解析 JSON,捕获解析异常作为业务错误处理。这种机制将网络层故障与应用层数据校验分离,使调用方能明确知道是连接问题还是数据格式问题。

async function standardFetch(url, options = {}) {
try {
const response = await fetch(url, options);
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const data = await response.json();
return { success: true, data: data };
} catch (error) {
return { success: false, error: error.message };
}
}
使用上述代码发起请求时,若服务器返回 404 或 500,standardFetch 会返回 { success: false, error: 'HTTP error! status: 404' };若服务器正常返回 JSON 但字段缺失导致解析失败,则返回 { success: false, error: 'Unexpected token...' }。调用方只需检查 success 字段即可统一处理结果。
如何处理非 JSON 类型的响应体
当接口可能返回文本、XML 或其他非 JSON 格式时,应在解析前检查 Content-Type 响应头。通过 response.headers.get('content-type') 获取类型,若包含 application/json 则执行 JSON 解析,否则保留原始文本或调用其他解析方法。这样可避免因强制解析导致的崩溃,同时保持返回结构的一致性。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

async function flexibleFetch(url, options = {}) {
const response = await fetch(url, options);
const contentType = response.headers.get('content-type');
let parsedData;
if (contentType && contentType.includes('application/json')) {
parsedData = await response.json();
} else {
parsedData = await response.text();
}
return { success: response.ok, data: parsedData };
}
该函数在处理 HTML 页面或纯文本接口时,会将 data 字段设为字符串而非对象,而 success 仍准确反映 HTTP 状态。开发者可根据 typeof data 进一步决定后续处理逻辑,无需为不同接口编写不同的错误捕获块。
基于 success 字段为 false 时的具体错误信息提取
当 success 为 false 时,error 字段仅包含简短消息。若需深入排查,可在 catch 块中保留原始 Error 对象,并在返回结构中增加 rawError 字段。例如,对于网络超时或 CORS 错误,原始对象包含更详细的堆栈或原因,便于日志记录或用户提示。
async function detailedFetch(url, options = {}) {
try {
const response = await fetch(url, options);
if (!response.ok) throw new Error(`Status: ${response.status}`);
return { success: true, data: await response.json() };
} catch (err) {
return { success: false, error: err.message, rawError: err };
}
}
此版本在出错时返回 { success: false, error: '...', rawError: ErrorObject }。调用方可通过 console.error(result.rawError) 查看完整堆栈,或在 UI 上显示友好提示。这种设计兼顾了简洁性与调试深度,适用于生产环境中的复杂错误追踪场景。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










