前端日志系统是排查问题、监控体验和优化性能的关键工具，需具备采集、分级、上报、存储与展示能力。首先定义日志级别（debug、info、warn、error、fatal），线上通常只上报warn及以上以控制数据量；结合自动采集（JS错误、Promise异常、资源加载失败、框架错误钩子、性能指标）与手动打点（如Logger.info('checkout_step', {step: 1})）实现全面覆盖；上报策略采用异步（sendBeacon或Image）、批量、采样和本地缓存兜底机制，避免影响性能；服务端需验证来源、解析存储日志至数据库或ELK等系统，并提供查询接口；通过Kibana或自建控制台实现可视化，支持按时间、用户、错误类型过滤，展示错误趋势与用户行为路径；系统建设应循序渐进，从捕获JS错误和基础打点起步，形成“有问题→查日志→定位→修复→验证”的闭环，确保实用性和可维护性。
前端日志系统并不是一个“可有可无”的功能，尤其在复杂应用中，它是排查问题、监控用户体验、优化性能的重要手段。直接把 console.log 留在线上代码里显然不可取。一个合理的前端日志系统需要具备采集、分级、上报、存储和展示的能力。下面从设计思路到实现要点，一步步说明如何构建一个实用的前端日志系统。
日志的分类与级别设计
不是所有信息都叫“日志”，也不是所有日志都值得上报。合理分类和设定级别，能有效控制数据量并提升排查效率。
常见的日志级别包括：
- debug：调试信息，开发阶段使用，线上通常关闭
- info：关键流程提示，如页面加载完成、用户登录成功
- warn：潜在问题，比如接口返回了非预期但可恢复的数据
- error：错误，如 JS 抛出异常、接口请求失败
- fatal：严重错误，可能导致功能中断，需立即处理
通过设置日志级别阈值（例如线上只收集 warn 及以上），可以避免日志爆炸。
立即学习“前端免费学习笔记（深入）”；
自动采集与手动打点结合
一个完整的日志系统不能只依赖开发者主动写 log，必须支持自动捕获常见异常。
可自动采集的内容包括：
- JavaScript 错误：window.onerror 和 addEventListener('error')
- Promise 异常：window.addEventListener('unhandledrejection')
- 资源加载失败：图片、脚本、样式表加载异常
- Vue/React 全局错误钩子：如 Vue 的 app.config.errorHandler
- 性能指标：FP、FCP、LCP 等可通过 PerformanceObserver 获取
同时保留手动打点接口，便于在关键业务逻辑中插入日志，比如：
Logger.info('checkout_step', { step: 1, userId: 'u_123' });
日志上报策略与性能优化
日志如果处理不当，可能拖慢页面甚至影响主流程。因此上报机制要兼顾可靠性和轻量性。
常用策略包括：
- 异步上报：使用 navigator.sendBeacon 或 Image(new Image()) 上报，避免阻塞页面卸载
- 批量上报：将日志缓存，达到一定数量或时间间隔后统一发送
- 采样上报：高流量场景下对 info 级别日志进行采样（如 1%）
- 本地缓存兜底：利用 localStorage 缓存未上报日志，下次打开时补发
注意控制单次上报大小，避免触发浏览器限制或服务器拒绝。
服务端接收与可视化展示
前端日志最终要落到服务端才能发挥价值。通常需要一个简单的后端接口接收日志数据。
后端职责包括：
- 验证来源（Referer、Token）防止恶意刷日志
- 解析日志结构并存入数据库（如 MySQL、MongoDB）或日志系统（如 ELK、Sentry）
- 提供查询接口，支持按时间、用户、错误类型等过滤
可视化方面，可以直接用 Kibana 配合 Elasticsearch，也可以自己做一个简单的 Web 控制台，展示错误趋势、Top 异常、用户行为路径等。
基本上就这些。一个轻量但完整的前端日志系统，核心是“可控采集 + 智能上报 + 可查可溯”。不需要一开始就大而全，可以从捕获 JS 错误和手动 info 打点做起，逐步扩展。关键是形成闭环：有问题 → 查日志 → 定位 → 修复 → 验证。这样的系统才真正有用。
