Vue 3 的 app.config.errorHandler 不捕获请求超时异常,因其属于 Axios/fetch 的 Promise reject;需在响应拦截器中识别 ECONNABORTED 或 timeout 消息并标准化处理,辅以 unhandledrejection 兜底监听,结合轻量提示与可选重试。

请求超时异常在 Vue 3 中**不会被 app.config.errorHandler 自动捕获**,因为它属于 Axios(或 fetch)Promise 链中的 reject,而 Vue 的 errorHandler 只覆盖 Vue 管理的异步上下文(如生命周期、watch、render),不接管原生 Promise 拒绝。要统一处理超时异常,核心在于拦截请求层的错误,并标准化归口。
超时错误的本质和触发时机
当使用 Axios 发起请求并设置了 timeout: 5000,若 5 秒内无响应,Axios 会主动 reject 一个带有 code: 'ECONNABORTED' 和 message: 'timeout of 5000ms exceeded' 的错误对象。这个错误发生在 Promise 内部,未被 catch 就会变成 unhandled rejection —— 这正是需要拦截的关键点。
在 Axios 响应拦截器中统一识别和处理
推荐在封装的 request 实例的响应拦截器中集中判断超时,并转换为标准错误格式,再交由统一错误处理器或业务逻辑消费:
- 检查
error.code === 'ECONNABORTED'或error.message.includes('timeout') - 补充自定义字段如
type: 'request-timeout'、url、method - 可选择:直接提示用户“网络较慢,请稍候重试”,或返回特定错误对象供上层
try/catch处理
配合全局 Promise 拒绝监听兜底
为防漏掉未被拦截器捕获的超时 reject(例如手动 new Promise + timeout 场景),需补充浏览器级兜底:
立即学习“前端免费学习笔记(深入)”;
- 监听
window.addEventListener('unhandledrejection', e => { ... }) - 在回调中过滤出超时类错误(通过
e.reason?.code或e.reason?.message) - 避免重复上报:与 Axios 拦截器逻辑共享同一份错误分类和上报函数
与业务错误提示联动(非崩溃式反馈)
超时不是代码缺陷,而是环境问题,适合轻量提示而非弹窗报错:
- 在拦截器中调用统一提示函数,如
showToast('请求超时,请检查网络', 'warn') - 对关键操作(如提交订单)可自动重试一次,而非立即失败
- 记录日志时带上设备网络类型(navigator.onLine / effectiveType),便于后续分析超时高发场景


















