SuperAPI AI 工具集

sentry-upgrade-migration

编程与开发

查看项目

更新于 10-15 23:29

技能介绍

用途:帮助把项目中的 Sentry SDK 升级到新版本,并处理升级伴随的破坏性 API 变更,主要覆盖 JavaScript v7 到 v8、Python SDK v1 到 v2。

主要能力:检测当前已安装的 Sentry 包与版本;扫描代码库中需要迁移的废弃写法;运行官方 @sentry/migr8 代码修改工具;对 codemod 未覆盖的模式给出手动修复示例;升级后用测试事件、span、breadcrumb 与 flush 验证。

使用方式:先用 npm ls 和 pip show 确认版本与包一致性;用 grep 扫描旧 API;npm install @sentry/node@7 后运行 npx @sentry/migr8@latest,再升级到 v8;按文档替换旧 API;在非生产环境运行测试并逐步发布。

关键破坏性变更:v8 移除 Hub,改用 Scope API 与 withScope;Transaction/Span 改为 startSpan() 回调;集成由类改为函数;@sentry/tracing 被移除;ESM 初始化需独立文件配合 --import;自定义 transport 需返回响应。Python v2 用 get_current_scope()/new_scope() 替代 configure_scope()/push_scope()。

限制与前提:需已确认目标版本 changelog,准备非生产测试环境,所有 @sentry/* 包保持同一主版本,SDK v8 需 Node.js >= 18.19.0 或 >= 20.6.0。具体价格、授权等资料未提供。