Gin 集成 Sentry 必须闭环三件事：sentry.Init() 在 main() 开头初始化并校验错误、所有 panic（含 goroutine）需 defer sentry.Recover() 捕获、HTTP 上下文须在中间件中用 sentry.ConfigureScope() 手动注入路径与 Header 等信息。
直接上结论：Gin 部署中集成 Sentry 实现有效错误监控告警，核心不是“装 SDK”，而是三件事必须闭环——sentry.Init() 在 main() 开头无错初始化、所有 panic 必须被 defer sentry.Recover() 捕获（含 goroutine）、HTTP 上下文（路径、Header 等）必须在中间件里用 sentry.ConfigureScope() 手动注入。漏掉任一环，线上报错就静默丢失。
为什么 sentry.Init() 放错位置会导致全量丢错误
sentry.Init() 失败不会 panic，只会静默丢弃后续所有上报。常见错误包括：
- 没检查返回值：
if err := sentry.Init(...); err != nil { log.Fatal(err) }缺失，导致 DSN 格式错误（比如漏了https://或路径）时完全无感知 - 放在
init()函数里：包初始化阶段无法 recover panic，且一旦 Init 失败，整个服务启动失败但日志不显眼 - 环境未隔离：
Environment: "development"没配，导致开发环境错误混入生产数据流，聚类失效 - 没开
Debug: true：上线前本地验证时看不到 SDK 是否真正连上 Sentry 服务端
panic 没进 Sentry？先查 Recovery 中间件顺序和 goroutine 处理
Gin 默认的 gin.Recovery() 只终止 panic 并返回 500，不发 Sentry。必须自己接管：
-
router.Use(gin.RecoveryWithWriter(..., customRecovery))是唯一安全扩展点，customRecovery函数内调用sentry.CaptureException(err) -
gin.Recovery()必须是第一个中间件，否则前面中间件 panic 时它还没执行，错误就漏了 - 所有显式起的 goroutine（如
go func(){...}()）必须自己加defer sentry.Recover()，Sentry 的全局 handler 对 goroutine 无效 - 别在 handler 里再写
defer recover()：会绕过 Recovery 中间件，导致 Sentry 和统一日志双漏
错误堆栈里看不到请求路径和 Header？中间件没配 scope
Sentry Go SDK 默认不读 *gin.Context，c.Request.URL.Path 和 c.Request.Header 不会自动上传。必须在中间件里手动塞：
- 用
sentry.ConfigureScope()包裹c.Next()前的逻辑，确保每个请求的 scope 独立 -
scope.SetTag("http.path", c.Request.URL.Path)和scope.SetTag("http.method", c.Request.Method)是最低可用信息 -
c.Request.Header是 map[string][]string，不能直接传；需遍历过滤敏感字段（如"Authorization"、"Cookie"），只保留"User-Agent"、"X-Request-ID"等安全 key - 别传
c.Request.Body：含隐私且易超长被 Sentry 截断，scope.SetExtra()也慎用大对象
告警没触发？检查 flush、进程退出和错误类型
上报成功 ≠ 告警触发。常见断点：
- 进程退出前没
defer sentry.Flush(2 * time.Second)：SIGTERM 或os.Exit()会丢掉缓冲区里的事件 - 只依赖 panic 上报：业务错误（如
if err != nil { /* DB timeout */ }）必须显式sentry.CaptureException(err)，否则 Sentry 根本收不到 - 高频低价值 error（如参数校验失败）全量上报：快速耗尽 quota，建议按 error 类型或频率限流
- 告警规则配在 Sentry 控制台里，但没绑定正确
Environment或Release，导致匹配不到事件
最常被忽略的一点：goroutine panic 后程序还在跑，Sentry 控制台却空着——因为没人给那个 goroutine 加 defer sentry.Recover()。别假设“主线程 recover 了就万事大吉”。
