通过封装一个统一的请求函数,在内部拦截响应并统一处理 http 状态码与 json 解析错误,将成功数据、错误信息或网络异常标准化为固定结构的对象返回。具体做法是定义一个包含 url、method、headers 和 body 的配置对象,调用 fetch 后检查 response.ok,若失败则抛出带有明确错误码的 error 实例,成功则解析 json 并包裹在 { success: true, data } 结构中。这样调用方无需关心底层细节,只需判断返回对象的 success 字段即可。

如何处理非 200 状态码导致的请求失败
当服务器返回 4xx 或 5xx 状态码时,Fetch API 默认不会拒绝 Promise,而是正常 resolve 一个 Response 对象,因此必须显式检查 response.ok 属性来识别错误。如果未做此检查,后续尝试解析 JSON 可能会因 HTML 错误页面而抛出语法错误,导致调试困难。正确的做法是在 fetch 链中立即判断,若 !response.ok 则根据状态码构造具体的业务错误对象并 throw 出去,从而让外层的 catch 捕获到标准化的错误信息而非原始的网络响应。

async function request(url, options = {}) {
const defaultOptions = {
headers: { 'Content-Type': 'application/json' },
};
const config = { ...defaultOptions, ...options };
try {
const response = await fetch(url, config);
if (!response.ok) {
const errorData = await response.json().catch(() => ({}));
throw new Error(`HTTP ${response.status}: ${errorData.message || 'Unknown error'}`);
}
const data = await response.json();
return { success: true, data };
} catch (error) {
return { success: false, error: error.message };
}
}
// 使用示例
const result = await request('/api/user', { method: 'POST', body: JSON.stringify({ id: 1 }) });
console.log(result); // { success: true/false, data/error }
如何统一处理网络异常与 JSON 解析错误
网络断开、DNS 解析失败或 CORS 拦截等异常情况会直接导致 fetch 抛出 TypeError,这类错误没有 HTTP 状态码,属于客户端层面的故障。同时,即使状态码为 200,如果服务器返回的不是合法 JSON(如纯文本或空响应),response.json() 也会抛出 SyntaxError。为了规范化结果,需要在 try...catch 块中捕获这两类异常,并将它们统一转换为包含 type 和 message 的标准错误结构。对于网络错误,标记类型为 NETWORK_ERROR;对于解析错误,标记类型为 PARSE_ERROR,确保前端 UI 能根据类型展示不同的提示文案。

async function safeRequest(url, options = {}) {
try {
const response = await fetch(url, options);
if (!response.ok) {
let errorMsg = `Server Error ${response.status}`;
try {
const json = await response.json();
errorMsg = json.message || errorMsg;
} catch (e) {}
throw { type: 'HTTP_ERROR', status: response.status, message: errorMsg };
}
let data;
try {
data = await response.json();
} catch (e) {
throw { type: 'PARSE_ERROR', message: 'Invalid JSON response' };
}
return { success: true, data };
} catch (err) {
if (err.type) {
return { success: false, error: err };
}
// 网络错误或未知错误
return { success: false, error: { type: 'NETWORK_ERROR', message: err.message } };
}
}
基于 POST 请求携带 Body 时的序列化问题
在使用 POST 方法提交数据时,必须手动设置 Content-Type 为 application/json 并将 JavaScript 对象序列化为字符串,否则后端可能无法正确读取参数。如果在配置中未指定 headers,Fetch 默认不发送 Body 或将其视为表单数据,导致接口报错。规范化的做法是在请求封装层提供默认的 Headers 配置,并在用户传入 body 时自动执行 JSON.stringify,同时确保 body 字段在最终传递给 fetch 前已被正确处理,避免重复序列化或格式错误。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











