#概述

小程序错误日志平台是一个专门用于收集、分析和管理小程序运行时JavaScript异常错误的工具平台。它帮助开发者快速定位和解决线上问题，提升小程序的稳定性和用户体验。

#功能特性

错误日志平台提供以下核心功能：

• 错误收集与聚合：自动收集小程序运行时的JavaScript异常
• SourceMap 还原：支持错误堆栈的源码映射，便于定位问题
• 多维度统计：提供错误趋势、内容及列表等多种视图
• 实时监控：提供近30天的错误数据查询和监控

指南：

1. 登录 涂鸦开发者平台
2. 进入小程序管理页面
3. 点击“JS异常”进入错误日志平台

#一、IDE SourceMap 上传

#1.1 上传配置

SourceMap 文件是调试和错误定位的重要工具，上传流程如下：

• 发布前需要在 IDE 中勾选"上传 SourceMap"选项
• SourceMap 文件会上传到私有存储桶
• 地址信息按版本维度存储在数据库中

#1.2 存储策略

为了控制存储成本，SourceMap 文件的存储策略如下：

• 存储期限：30天
• 存储位置：私有云存储桶
• 版本关联：每个小程序版本对应独立的 SourceMap 文件

#二、错误概览

#2.1 APP 筛选控制

错误日志可被筛选到的APP：

• 公版 APP
• 小程序开发者创建的 OEM App
• 小程序开发者被授权的 OEM App （企业内空间授权）

#2.2 错误概览与趋势

折线图展示

• 错误数量趋势变化
• 错误率统计分析
• 支持时间范围筛选（最长30天）

#三、错误聚合与搜索

#3.1 错误聚合

系统对同类错误进行智能聚合，提供以下特性：

• 聚合策略：相同错误堆栈的错误会被归类到一起
• 排序方式：按报错次数降序排列
• 分页支持：支持分页查询，提升查看体验

#3.2 搜索功能

堆栈搜索：

• 支持错误堆栈的模糊搜索
• 可快速定位特定类型的错误

账号查询：

• 支持按 C 端账号维度查询
• 需要选择固定的 App 进行查询

#四、错误详情

错误详情页面提供全面的错误信息：

堆栈信息：

• 完整的错误堆栈跟踪
• 支持 SourceMap 还原的源码定位
• 错误发生的具体代码位置

基本信息：

• 错误发生的APP信息
• 错误发生的版本信息
• 错误发生的页面路径
• 错误发生的时间点

SourceMap还原

点击源码查看可进行 SourceMap 还原：

• 确保该版本已上传 SourceMap 文件
• 系统自动还原错误堆栈到源码位置

// 还原前的压缩代码错误堆栈
at n (main.js:1:2345)
at r (main.js:1:6789)

// 还原后的源码错误堆栈
at handleUserAction (pages/index/index.js:45:12)
at onClick (components/button/button.js:23:8)

#五、最佳实践

#5.1 错误监控策略

主动监控：

• 定期查看错误概览趋势
• 关注错误量突增的时间点
• 重点关注新版本发布后的错误情况

版本对比：

• 对比不同版本间的错误率
• 识别版本升级引入的新问题
• 验证修复效果

#5.2 问题定位技巧

利用 SourceMap：

• 确保每个版本都上传了 SourceMap
• 使用还原功能快速定位源码位置
• 结合代码审查工具进行问题分析

多维度分析：

• 结合用户反馈和错误日志
• 分析错误的设备和系统分布
• 关注高频错误的共同特征