用途:系统性诊断并修复 Sentry SDK 集成中高频出现的问题,覆盖 Node.js、浏览器和 Python 环境。
主要能力:涵盖 DSN 缺失或格式错误、事件不上报、source map 无法解析、HTTP 429 限流、SDK 版本冲突、环境标签错误、浏览器 CORS、Node.js 进程提前退出、Express 未被插桩等场景,并给出错误与成因对照表。
必要用法:先探测已安装 SDK 与现有配置,例如运行 !npm list @sentry/node @sentry/browser @sentry/react @sentry/nextjs 2>/dev/null | head -10、!python3 -c "import sentry_sdk; print(f'sentry-sdk {sentry_sdk.VERSION}')"、!command -v sentry-cli >/dev/null && sentry-cli --version;再用 grep -rn "Sentry.init|sentry_sdk.init" 定位初始化代码。排查时开启 debug: true,发送测试事件并 await Sentry.flush(2000)。source map 需保证 Sentry.init 的 release 与 sentry-cli releases 上传版本完全一致,且 --url-prefix 匹配浏览器加载路径,可用 sentry-cli sourcemaps explain 诊断。
适用场景:事件不上报、堆栈被压缩、限流丢事件、serverless/CLI 事件消失、Express 未插桩等。
限制:只针对 Sentry 集成常见错误,具体版本行为与配额策略需以资料所列文档为准,部分步骤和工具链接暂未提供。