sentry-miniapp小程序监控 SDK

一个基于 @sentry/core 构建的小程序监控 SDK，覆盖异常、性能、日志、离线缓存与链路追踪；支持微信、支付宝、字节跳动、百度、QQ、钉钉、快手等小程序，以及微信 / 抖音小游戏，并兼容 Taro / uni-app。

开始接入

先确认是否适用

查看支持范围

🛡️

发现并还原线上问题

自动捕获未处理异常、Promise rejection 和内存告警，结合用户操作、页面与网络上下文定位问题。

📊

看懂性能与请求链路

采集启动、渲染、资源和请求耗时，可通过 http.client span 与追踪头串联服务端调用链。

📡

面对弱网与隐私要求

发送失败后写入本地缓存并自动重试；需要用户授权时，可在同意前采集但不发送网络请求。

Sentry Community SDK已收录进 Sentry 官方文档索引7 大小程序平台微信 / 支付宝 / 字节 / 钉钉 / QQ / 百度 / 快手微信 / 抖音小游戏异常、冷启动、帧率与卡顿监控持续自动化验证GitHub Actions 覆盖多 Node.js 版本

选择接入方式

从你的工程类型开始

先进入对应框架的接入页，再完成初始化和测试事件验证。框架组件错误、入口位置和条件编译会在各自指南中说明。

Native

原生小程序

微信、支付宝、字节跳动、钉钉、QQ、百度和快手原生工程。

快速接入 React

Taro

处理入口初始化、React 错误边界以及小程序 / H5 分端接入。

查看 Taro 指南 Vue

uni-app

处理 main.js 初始化、Vue errorHandler 与条件编译。

查看 uni-app 指南 Game

微信 / 抖音小游戏

接入异常监控，并采集冷启动首帧、FPS 和卡顿汇总。

查看小游戏指南

安装并验证

第一次接入只做两件事：尽早初始化，然后主动发送一个测试错误。确认 Sentry Issues 中能看到事件后，再继续配置生产环境能力。

bash

npm install sentry-miniapp --save
# 或 yarn add sentry-miniapp

import * as Sentry from 'sentry-miniapp';

Sentry.init({
  dsn: 'https://your-dsn@o0.ingest.sentry.io/0',
  release: 'my-miniapp@1.0.0',
  environment: 'production',
});

Sentry.captureException(new Error('sentry-miniapp test'));