使用 fetch 发起请求后,必须调用 .json() 或 .text() 方法获取响应体,并检查 response.ok 属性来验证 http 状态码。若状态码不在 200-299 范围内,应主动抛出错误以中断后续逻辑。对于业务层面的数据校验,需在解析完 json 后对返回的结构进行类型和字段检查,确保数据符合预期格式。

如何区分网络错误与业务错误
fetch 仅在网络故障(如断网、DNS 失败)时才会 reject Promise,而 HTTP 4xx 或 5xx 状态码默认被视为成功响应。因此,必须在获取响应后立即检查 response.ok,否则程序会错误地继续执行并尝试解析无效的业务数据。

async function fetchData(url) {
try {
const response = await fetch(url);
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const data = await response.json();
return data;
} catch (error) {
console.error('Fetch failed:', error);
throw error;
}
}
上述代码展示了标准的错误处理流程。当服务器返回 404 或 500 时,response.ok 为 false,代码会抛出包含状态码的错误信息。捕获块会记录日志并重新抛出错误,调用方可以据此区分是网络层问题还是服务端问题。
如何验证返回数据的结构合法性
在确认 HTTP 响应成功后,还需要验证 JSON 数据的结构是否符合预期。这通常通过检查关键字段是否存在且类型正确来实现。如果数据结构不符合要求,应抛出明确的业务错误,防止下游代码因访问 undefined 属性而崩溃。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

function validateUserData(user) {
if (!user || typeof user !== 'object') {
throw new Error('Invalid user data structure');
}
if (typeof user.id !== 'number' || typeof user.name !== 'string') {
throw new Error('User data fields are invalid');
}
return true;
}
结合之前的 fetchData 函数,可以在获取数据后调用 validateUserData。例如,若 API 返回的是 { id: "1", name: 123 },验证函数将检测到类型不匹配并抛出错误。这种双重验证机制确保了从网络传输到业务逻辑的数据完整性。
如何处理特定业务状态码下的数据异常
某些 API 可能在 HTTP 200 状态下返回表示错误的业务标志位,例如 { success: false, message: "Token expired" }。此时需要检查响应体中的特定字段来判断业务逻辑是否成功。若发现业务错误,应根据具体场景决定是重试、跳转登录页还是提示用户。
async function checkBusinessStatus(response, data) {
if (!response.ok) return; // 已处理 HTTP 错误
if (data.success === false) {
throw new Error(`Business error: ${data.message}`);
}
return data;
}
该辅助函数扩展了基础验证逻辑。它首先假设 HTTP 状态已验证,然后检查 data.success 字段。如果业务逻辑标记为失败,则抛出包含详细消息的错误。这种模式允许前端统一处理网络层和业务层的异常,保持代码的清晰性和可维护性。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










