await 遇到被拒绝的 promise 会立即抛出异常,需用 try...catch 捕获;若要统一处理失败,可用 .catch 转换为成功状态或封装工具函数,注意区分网络异常(reject)与 http 错误(resolve)。

await 表达式本身无法“等待”被拒绝的 Promise——它会直接抛出错误,而不是暂停执行并返回拒绝值。
await 遇到 rejected Promise 会抛出异常
当 await 后面跟一个被拒绝(rejected)的 Promise 时,JavaScript 不会继续往下执行,而是立即以该 rejection 原因(reason)抛出一个异常,就像 throw 一样。这和 try...catch 的行为一致。
- 如果没用 try...catch 包裹,错误会向上冒泡,可能导致整个 async 函数中断、未捕获异常
- 如果用了 try...catch,就能捕获这个 rejection 原因,实现“处理失败”的逻辑
正确处理被拒绝的 Promise
想安全地等待一个可能失败的 Promise,必须配合 try...catch:
async function fetchUserData() {
try {
const data = await fetch('/api/user'); // 如果 fetch 失败,这里抛错
const user = await data.json();
return user;
} catch (error) {
console.error('请求失败:', error);
return null; // 或者抛出自定义错误、返回默认值等
}
}
想“拿到”拒绝原因而不抛错?用 Promise.prototype.catch
如果目标是让 await 总是成功返回(比如返回 { ok: false, error } 这类结构),可以提前用 .catch 消化 rejection:
- 方式一:链式调用 .catch —— 把 rejected Promise 转成 resolved Promise
- 方式二:封装工具函数,如 promiseWithCatch(promise) 返回 [result, error]
例如:
const safeFetch = async () => {
try {
const res = await fetch('/api/data').catch(err => err);
if (res instanceof Error) {
return { ok: false, error: res.message };
}
return { ok: true, data: await res.json() };
} catch (err) {
return { ok: false, error: '未知错误' };
}
};
注意:reject 不等于网络错误
fetch 等 API 的 rejection 通常只发生在网络异常(如离线、DNS 失败);HTTP 错误状态码(如 404、500)仍会返回 resolve 的 Response 对象,需手动检查 response.ok 或 response.status。
- 所以“被拒绝” ≠ “HTTP 错误”,别混淆 Promise rejection 和业务失败
- 常见误区:以为 await fetch(...).then(...) 能避免抛错——其实 .then 不影响 await 的行为,除非你 .catch 了











