Vue3前端日志配置核心是三步:统一日志入口、捕获三类错误(Vue errorHandler、unhandledrejection、window.onerror)、本地缓存+智能上报(卸载前/阈值触发),并支持路由与接口自动打点。

Vue 3 项目配置前端本地日志收集与异常上报,核心是分三步走:统一日志入口、捕获关键错误源、按需存储并上报。不依赖 console.log,而是用结构化、可配置、环境感知的方式把日志变成可观测数据。
一、封装日志工具类,替代 console
新建 src/utils/logger.js,提供分级日志方法(debug/info/warn/error),自动注入时间、环境、模块名等上下文:
- 每条日志包含 level、message、timestamp、env(dev/prod)、page(当前路由)、component(可选)
- 开发环境输出到控制台并保留原始堆栈;生产环境默认静默,仅存内存或触发上报
- 支持动态开关:通过
import.meta.env.VUE_APP_LOG_ENABLE控制是否启用
二、覆盖三类错误捕获通道
单一 errorHandler 不够——它漏掉 Promise 异常、资源加载失败、定时器错误。必须组合使用:
-
Vue 全局错误处理器:
app.config.errorHandler捕获组件内同步/异步渲染、watch、生命周期错误 -
全局 Promise 拦截:
window.addEventListener('unhandledrejection')捕获未 catch 的 axios/fetch 请求拒绝 -
JS 运行时错误兜底:
window.onerror捕获语法错误、脚本加载失败、跨域资源异常
所有捕获到的错误都交由 logger.error 统一格式化,避免重复打印或丢失上下文。
三、本地暂存 + 智能上报策略
日志不是“产生即发”,而是先缓存、再择机上传:
- 使用数组在内存中暂存日志(如
const logBuffer = []),配合 Pinia 或 provide/inject 实现跨组件共享 - 触发上报时机包括:页面卸载前(beforeunload)、错误达到阈值(如 5 条 error)、用户主动刷新/跳转
- 上报前做轻量过滤:剔除重复错误(基于 stack hash)、忽略白名单资源(如 cdn 字体、埋点脚本)
- 生产环境启用压缩与节流,避免高频请求打垮后端
四、路由与接口行为自动打点(可选增强)
让日志更贴近业务,无需每个页面手动写 log:
- 在
router.beforeEach中记录页面进入、停留时长、来源页 - 用 axios 拦截器自动记录请求 URL、method、耗时、状态码、响应大小(非敏感字段)
- 对关键操作(如登录、提交表单)显式调用
logger.info('user_login_success', { userId })
这些行为日志和错误日志共用同一缓冲区与上报通道,结构一致,便于后端聚合分析。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










