Vue 3 错误处理核心是保留现场、显性提示、一键反馈:用 errorCaptured 捕获错误并存入响应式状态,配合右下角非阻塞浮层展示摘要与详情,支持复制和上报;补充 unhandledrejection/onerror 监听未捕获错误;上报时携带唯一 errorId 实现追踪闭环。

在 Vue 3 中,当出现未知错误时提供可操作的反馈入口,关键不是“拦截后弹窗提示”,而是让错误可见、可触达、可上报,同时不打断用户当前操作。核心思路是:错误发生时,保留现场 + 显性提示 + 一键反馈通道。
用 errorCaptured 钩子捕获并透出错误上下文
全局 errorHandler 只负责收口,真正让用户能反馈的入口,需要落到具体组件中。推荐在根布局或错误兜底页(如 ErrorBoundary 组件)里使用 errorCaptured 钩子:
- 它能捕获子组件树中抛出的未处理错误,并拿到
err、instance、info三元信息 - 把
err.message和info(比如 “render function” 或 “onMounted hook”)存入组件响应式状态,用于后续展示 - 配合
return false阻止错误冒泡,避免整个页面白屏或崩溃
设计轻量级错误浮层,带“复制详情”和“提交反馈”按钮
不要强制中断流程,而是以非阻塞方式提示用户:
- 浮层固定在右下角,含简明错误摘要(如“页面加载异常,请重试”)
- 点击展开完整错误信息:堆栈、时间戳、当前路由、浏览器 UA、Vue 组件名
- 提供“一键复制”按钮,方便用户粘贴给技术支持
- “提交反馈”按钮调用统一上报接口,携带
err.stack、location.href、performance.now()等上下文
为无法捕获的错误补上降级反馈路径
app.config.errorHandler 捕不到 Promise reject、资源加载失败等,这些错误仍可能造成功能异常但无提示。此时需补充:
- 监听
window.addEventListener('unhandledrejection'),将 reject 原因存入全局错误池 - 监听
window.onerror,对message含 “Script error” 或资源 404 的情况打标记 - 在用户主动点击“帮助”、“联系客服”或刷新页面前,检查错误池是否有未上报项,自动唤起反馈浮层
后端配合提供可追踪的错误 ID
前端上报错误时,附带一个唯一 errorId(如 ERR-${Date.now()}-${Math.random().toString(36).substr(2, 9)}),后端记录并返回短链或二维码。用户反馈时只需提供该 ID,研发可快速定位原始日志、用户行为序列和前后端调用链,真正形成闭环。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











