Sentry React Native 设置指南：安装配置错误监控与性能追踪

sentry-react-native-setup by getsentry/sentry-agent-skills

126 周安装量

19 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/getsentry/sentry-agent-skills --skill sentry-react-native-setup

React 移动应用监控

🇨🇳中文介绍

Sentry React Native 设置指南

使用官方向导 CLI 在 React Native 项目中安装并配置 Sentry。

适用场景

用户要求“在 React Native 应用中添加 Sentry”或“安装 Sentry”
用户希望在 React Native 或 Expo 应用中实现错误监控、日志记录或追踪功能
用户提及“@sentry/react-native”或移动端错误追踪

重要提示： 下方的配置选项和代码示例仅供参考。在实施前，请务必查阅 docs.sentry.io 进行核实，因为 API 和默认值可能已发生变化。

向导设置（推荐）

npx @sentry/wizard@latest -i reactNative

向导功能说明

任务	描述
安装 SDK	添加 `@sentry/react-native` 包
Metro 配置	在 `metro.config.js` 中添加 `@sentry/react-native/metro`

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

网站审计工具 - 使用 squirrelscan CLI 全面检测 SEO、性能、安全及技术问题

42,700 周安装

前端性能优化指南：识别瓶颈与优化策略，提升LCP、FID、CLS核心指标

41,500 周安装

前端代码审计工具 - 自动化检测可访问性、性能、响应式设计、主题化与反模式

41,500 周安装

Dogfood - Vercel Labs 自动化 Web 应用探索与问题报告工具

17,400 周安装

如果不使用向导，请在应用入口点添加以下代码：

import * as Sentry from "@sentry/react-native";

Sentry.init({
  dsn: "YOUR_SENTRY_DSN",
  sendDefaultPii: true,
  
  // 追踪
  tracesSampleRate: 1.0,
  
  // 日志
  enableLogs: true,
  
  // 性能分析
  profilesSampleRate: 1.0,
  
  // 会话回放
  replaysOnErrorSampleRate: 1.0,
  replaysSessionSampleRate: 0.1,
  integrations: [Sentry.mobileReplayIntegration()],
});

export default Sentry.wrap(App);

对于 Expo 项目，请遵循 Expo 专属设置指南：

npx @sentry/wizard@latest -i reactNative

适用于托管式（managed）和裸（bare）Expo 项目。

选项	描述	默认值
`dsn`	Sentry DSN	必填
`sendDefaultPii`	是否包含用户数据	`false`
`tracesSampleRate`	被追踪事务的百分比	`0`
`profilesSampleRate`	被分析追踪的百分比	`0`
`enableLogs`	是否将日志发送到 Sentry	`false`
`replaysOnErrorSampleRate`	发生错误的会话中被回放的百分比	`0`
`replaysSessionSampleRate`	所有会话中被回放的百分比	`0`

创建/修改的文件

文件	用途
`App.js` / `_layout.tsx`	Sentry 初始化
`metro.config.js`	Metro 打包器配置
`app.json`	Expo 配置（如果是 Expo 项目）
`ios/sentry.properties`	iOS 构建凭证
`android/sentry.properties`	Android 构建凭证
`env.local`	环境变量

SENTRY_DSN=https://xxx@o123.ingest.sentry.io/456
SENTRY_AUTH_TOKEN=sntrys_xxx
SENTRY_ORG=my-org
SENTRY_PROJECT=my-project

添加测试错误：

throw new Error("My first Sentry error!");

或使用测试按钮：

<Button title="Test Sentry" onPress={() => { throw new Error("Test"); }} />

当向导配置完成后，源映射会在构建过程中自动上传：

Android：通过 Gradle 插件
iOS：通过 Xcode 构建阶段

问题	解决方案
向导失败	尝试手动设置，检查 Node 版本
iOS 构建失败	运行 `cd ios && pod install`
源映射未上传	验证 `sentry.properties` 文件是否包含认证令牌
Expo 错误	确保使用兼容的 Expo SDK 版本
应用未包装	添加 `export default Sentry.wrap(App)`

🇺🇸English

Sentry React Native Setup

Install and configure Sentry in React Native projects using the official wizard CLI.

Invoke This Skill When

User asks to "add Sentry to React Native" or "install Sentry" in a React Native app
User wants error monitoring, logging, or tracing in React Native or Expo
User mentions "@sentry/react-native" or mobile error tracking

Important: The configuration options and code samples below are examples. Always verify against docs.sentry.io before implementing, as APIs and defaults may have changed.

Wizard Setup (Recommended)

npx @sentry/wizard@latest -i reactNative

What the Wizard Does

Task	Description
Install SDK	Adds `@sentry/react-native` package
Metro config	Adds `@sentry/react-native/metro` to `metro.config.js`
Expo config	Adds `@sentry/react-native/expo` to `app.json`
Android setup	Enables Gradle build step for source maps
iOS setup	Wraps Xcode build phase, adds debug symbol upload
Pod install	Runs `pod install` for iOS
Credentials	Stores in `ios/sentry.properties`, `android/sentry.properties`, `env.local`
Init code	Configures Sentry in `App.tsx` or `_layout.tsx`

Manual Configuration

If not using wizard, add to your app entry point:

import * as Sentry from "@sentry/react-native";

Sentry.init({
  dsn: "YOUR_SENTRY_DSN",
  sendDefaultPii: true,
  
  // Tracing
  tracesSampleRate: 1.0,
  
  // Logs
  enableLogs: true,
  
  // Profiling
  profilesSampleRate: 1.0,
  
  // Session Replay
  replaysOnErrorSampleRate: 1.0,
  replaysSessionSampleRate: 0.1,
  integrations: [Sentry.mobileReplayIntegration()],
});

Wrap Your App

export default Sentry.wrap(App);

Expo Projects

For Expo, follow the Expo-specific setup:

npx @sentry/wizard@latest -i reactNative

Works for both managed and bare Expo projects.

Configuration Options

Option	Description	Default
`dsn`	Sentry DSN	Required
`sendDefaultPii`	Include user data	`false`
`tracesSampleRate`	% of transactions traced	`0`
`profilesSampleRate`	% of traces profiled

Files Created/Modified

File	Purpose
`App.js` / `_layout.tsx`	Sentry initialization
`metro.config.js`	Metro bundler config
`app.json`	Expo config (if Expo)
`ios/sentry.properties`	iOS build credentials
`android/sentry.properties`	Android build credentials
`env.local`

Environment Variables

SENTRY_DSN=https://xxx@o123.ingest.sentry.io/456
SENTRY_AUTH_TOKEN=sntrys_xxx
SENTRY_ORG=my-org
SENTRY_PROJECT=my-project

Verification

Add test error:

throw new Error("My first Sentry error!");

Or use a test button:

<Button title="Test Sentry" onPress={() => { throw new Error("Test"); }} />

Source Maps

Source maps are automatically uploaded during build when wizard configures:

Android: Gradle plugin
iOS: Xcode build phase

Troubleshooting

Issue	Solution
Wizard fails	Try manual setup, check Node version
iOS build fails	Run `cd ios && pod install`
Source maps not uploading	Verify `sentry.properties` files have auth token
Expo errors	Ensure using compatible Expo SDK version
App not wrapped	Add `export default Sentry.wrap(App)`

Weekly Installs

126

Repository

getsentry/sentr…t-skills

GitHub Stars

First Seen

Jan 21, 2026

Security Audits

Gen Agent Trust HubPass SocketWarn SnykPass

Installed on

opencode107

codex105

gemini-cli101

claude-code101

cursor92

github-copilot92

Convex性能审计指南 - 诊断修复Convex应用性能问题与优化方案

14,200 周安装