---
title: 小程序错误日志平台
summary: "介绍小程序错误日志平台，用于收集和分析运行时 JS 异常，支持 SourceMap 还原定位。"
tags: [小程序错误日志平台, JS异常监控, SourceMap解析, 错误趋势分析]
questions:
- 小程序错误日志平台有哪些核心功能？
- 如何上传 SourceMap 文件？
- SourceMap 文件的存储策略是什么？
- 如何使用错误概览查看错误趋势？
- 错误聚合和搜索功能如何使用？
- 如何通过 SourceMap 还原定位源码错误位置？
- 错误日志平台支持筛选哪些 APP 的数据？
- 小程序错误监控有哪些最佳实践？
---
## 概述
小程序错误日志平台是一个专门用于收集、分析和管理小程序运行时JavaScript异常错误的工具平台。它帮助开发者快速定位和解决线上问题，提升小程序的稳定性和用户体验。
## 功能特性
错误日志平台提供以下核心功能：
- **错误收集与聚合**：自动收集小程序运行时的JavaScript异常
- **SourceMap 还原**：支持错误堆栈的源码映射，便于定位问题
- **多维度统计**：提供错误趋势、内容及列表等多种视图
- **实时监控**：提供近30天的错误数据查询和监控
指南：
1. 登录 [涂鸦开发者平台](https://platform.tuya.com/miniapp/)
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 文件
- 系统自动还原错误堆栈到源码位置
```javascript
// 还原前的压缩代码错误堆栈
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
- 使用还原功能快速定位源码位置
- 结合代码审查工具进行问题分析
**多维度分析**：
- 结合用户反馈和错误日志
- 分析错误的设备和系统分布
- 关注高频错误的共同特征