快速使用 Docker 上手 Sentry-CLI - 玩转 Source Maps 使用 (Create-React-App)

发布时间：2025-11-03 22:18:21 来源：云智核 作者：数据库

本文转载自微信公众号「黑客下午茶」，快速作者为少 。使用上手s使转载本文请联系黑客下午茶公众号。快速

系列

快速使用 Docker 上手 Sentry-CLI - 创建版本

入门

使用 sentry-cli 上传 source maps 时，使用上手s使您需要设置构建系统以创建版本(release)并上传与该版本对应的快速各种源文件。要让 Sentry 对您的使用上手s使堆栈跟踪进行解码，请同时提供：

如果 source map 文件不包含您的原始源代码 (sourcesContent)，您还必须提供原始源文件。使用上手s使如果源文件丢失，快速Sentry CLI 将尝试自动将源嵌入到您的使用上手s使 source maps 中。

Sentry 使用 releases 将正确的快速 source maps 与您的云服务器事件相匹配。要创建新版本，使用上手s使请运行以下命令(例如，快速在发布期间)：

release 名称在您的组织中必须是唯一的，并且与您的 SDK 初始化代码中的 release 选项相匹配。然后，使用 upload-sourcemaps 命令扫描文件夹中的 source maps，处理它们，并将它们上传到 Sentry。

您可以通过导航到 [Project] > Project Settings > Source Maps 找到上传到 Sentry 的工件。

此命令会将所有以 .js 和 .map 结尾的文件上传到指定的版本(release)。如果你想改变这些扩展 — 例如，亿华云计算上传 typescript 源文件 — 使用 --ext 选项：

到目前为止，该版本处于草稿状态(“unreleased”)。上传所有 source maps 后，您的应用程序已成功发布，使用以下命令完成 release：

实战

Create React App 快速创建一个 Demo

新建一个 typescript app 模板项目：

加入 @sentry/react，@sentry/tracing 包：

修改项目代码

进入 src/index.tsx，进行如下调整：

进入 src/App.tsx，进行如下调整：

加入 .sentryclirc 文件，详情可看上篇 -> 快速使用 Docker 上手 Sentry-CLI - 创建一个版本

编译项目

最终项目结构

上传 Source Maps

在项目根目录中，进入 sentry-cli docker 容器 shell 环境：

设置变量：

执行如下命令：

在 Sentry 后台，你应该看到如下图：

本地测试

如果你是 Mac 本地开发环境，可直接执行如下命令：

点击 Break the world 按钮：

正常情况下，错误已被上传到 Sentry，然后在错误详情中应看到如下图：

相关文章