在 javascript 异步错误处理中,async 函数捕获网络请求错误的标准做法是使用 try...catch 语句包裹 fetch 调用。由于 fetch 仅在发生网络故障(如 dns 失败、断网)时才会触发 reject,而 http 4xx 或 5xx 状态码会被视为成功响应,因此必须在 catch 块中检查 response.ok 属性,并在发现错误时手动抛出 error 对象,这样上层调用者才能通过 await 正常捕获到业务逻辑层面的异常。

fetch 对非 2xx 状态码的处理机制是什么
fetch API 的设计原则是仅在网络层故障时拒绝 Promise,对于服务器返回的 404 或 500 等状态码,它依然会 resolve 一个 Response 对象。这意味着如果不在代码中显式检查 response.ok,程序会误以为请求成功并继续执行后续逻辑,导致数据解析错误或业务逻辑混乱。开发者必须主动判断 status 是否在 200 到 299 之间,否则无法区分“请求成功但无数据”与“请求失败”的区别。

async function fetchData() {
try {
const response = await fetch('/api/data');
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
return await response.json();
} catch (error) {
console.error('Fetch failed:', error.message);
return null;
}
}
上述代码展示了完整的处理流程。当服务器返回 404 时,response.ok 为 false,代码进入 if 分支并抛出新的 Error。这个新抛出的错误会被 catch 块捕获,从而统一了网络错误和业务错误的处理路径。如果不进行 this check,response.json() 可能会因为 HTML 错误页面内容而抛出 SyntaxError,或者返回无效数据供后续使用。
如何区分网络故障与 HTTP 错误状态
在实际开发中,区分底层网络异常和高层 HTTP 错误有助于更精确的错误上报和重试策略。网络故障通常表现为 TypeError 且没有 response 对象,而 HTTP 错误则包含完整的 response 信息。通过在 catch 块中检查 error.response 是否存在,可以判断错误来源。这种区分允许开发者针对不同类型的错误采取不同的恢复措施,例如网络故障可尝试重试,而 403 禁止访问则不应重试。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

async function robustFetch(url) {
try {
const response = await fetch(url);
if (!response.ok) {
const error = new Error(response.statusText);
error.response = response;
throw error;
}
return await response.json();
} catch (error) {
if (error.response) {
console.log('HTTP Error:', error.response.status);
} else {
console.log('Network Error:', error.message);
}
throw error;
}
}
该示例代码在 catch 块中进行了细致的分类处理。当 throw new Error(...) 被触发后,我们将 response 对象附加到 error 实例上,使得 catch 块能够访问到原始的 HTTP 响应信息。这样,调用者可以通过检查 error.response 来判断是否为 HTTP 错误,从而实现更细粒度的错误控制。这种模式确保了无论错误类型如何,上层都能获得足够的上下文信息进行决策。
async 函数中未捕获的 Promise Rejection 会导致什么结果
如果在 async 函数内部发生了未被 try...catch 捕获的 Promise rejection,该错误将转化为 unhandled promise rejection。在现代浏览器和 Node.js 环境中,这通常不会直接终止进程,但会在控制台抛出警告,并可能导致内存泄漏或应用状态不一致。对于单页应用,未处理的 rejection 可能导致用户界面停留在加载状态或显示模糊的错误信息。因此,确保所有 await 表达式都在 try 块中是保证应用稳定性的关键。
async function riskyOperation() {
// 缺少 try-catch,fetch 失败将导致 unhandled rejection
const data = await fetch('/api/risky').then(r => r.json());
return data;
}
// 正确写法
async function safeOperation() {
try {
const data = await fetch('/api/safe').then(r => r.json());
return data;
} catch (e) {
// 处理错误
}
}
对比这两个函数,riskyOperation 使用了链式调用而非 await,虽然语法上合法,但如果 fetch 失败,错误不会被任何 try...catch 捕获,因为 await 并没有包裹整个链式调用。safeOperation 则正确地使用了 await 并包裹在 try 块中,确保任何阶段的错误都能被同步捕获。这种差异强调了在 async/await 模式下,始终使用 try...catch 包裹 await 表达式的重要性,以避免静默失败。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










