sentry_sdk.init()必须在fiber.App创建后、任何路由或中间件注册前立即调用，否则初始化阶段panic（如配置解析失败）将无法捕获；需显式传入FiberIntegration()并确保其作为首个中间件注册，否则request上下文丢失或异常被吞。
sentry_sdk.init() 必须在 fiber.App 创建后立即调用
Fiber 的启动流程极快，sentry_sdk.init() 若晚于 app := fiber.New() 执行，就可能错过初始化阶段的 panic（比如配置解析失败、中间件注册异常）。它不是“越早越好”，而是必须卡在 app 实例化之后、任何路由或中间件注册之前——因为 Fiber 的错误捕获依赖于其内部的 app.Use() 钩子注入，而 Sentry 的 FiberIntegration 正是通过这个机制挂载异常拦截器。
-
sentry_sdk.init()必须传入integrations=[FiberIntegration()]，否则 request URL、method、status 等上下文字段不会自动附加到事件中 -
environment参数建议显式设为"production"或"staging"，避免默认值"dev"导致告警规则失效 - 若使用自托管 Sentry，确保
dsn地址可被服务器直连（常见坑：内网部署未打通出口代理，上报超时静默丢弃）
Fiber 中间件注册顺序直接影响错误是否被捕获
Fiber 是链式中间件模型，Sentry 的 FiberIntegration 本质是一个前置中间件，靠 ctx.Next() 后的 defer 捕获 panic。如果它被注册在其他中间件之后（尤其是提前 ctx.Status(500).SendString(...) 的兜底 handler），异常就会被吞掉，根本不会冒泡到 Sentry。
- 正确顺序：先
app.Use(sentry.Recovery())（或等效的 Sentry 集成中间件），再注册自定义中间件和路由 - 错误写法示例：
app.Use(myAuthMiddleware); app.Use(sentry.FiberIntegration())→ auth 抛 panic 时 Sentry 还没注册，无法拦截 - 如果用了
fiber.New(fiber.Config{DisableStartupMessage: true})等配置，不影响 Sentry，但要确认没有在app.Get("/health", ...)里主动panic("test")测试——这类测试若发生在 init 之后，会上报；若发生在 init 之前，会丢失
手动捕获异常时别漏掉 context.Context 和用户标识
Fiber 的 handler 函数签名是 func(c *fiber.Ctx) error，你不能直接把 c 传给 sentry.CaptureException()。Sentry Go SDK 不识别 *fiber.Ctx，必须手动提取关键字段并注入 scope。
- 上报前应调用
sentry.WithScope()，设置scope.SetTag("path", c.Path())、scope.SetTag("method", c.Method()) - 用户信息需手动绑定：
scope.SetUser(sentry.User{ID: c.Locals("user_id").(string)})，前提是你的鉴权中间件已把 ID 存进c.Locals - 若在异步 goroutine 中触发错误（如
go func() { ... }()），原始c已不可访问，此时只能靠日志上下文或全局 traceID 关联，无法自动带 request 数据
before_send 过滤器返回 nil 才算丢弃，其他 falsy 值会导致静默失败
before_send 回调函数接收 event *sentry.Event 和 hint *sentry.EventHint，它的返回值语义非常严格：只接受 *sentry.Event（上报）、nil（丢弃）、或修改后的 *sentry.Event。返回 false、空 struct、map[string]interface{} 等都会让 Sentry 服务端拒绝该事件，且不报错，只在 debug 日志里记一句 Event dropped due to before_send returning falsy value。
- 健康检查过滤写法：
if strings.HasSuffix(event.Request.URL, "/health") { return nil } - 高频噪音过滤（如 DNS 解析失败）：
if hint.OriginalException != nil && strings.Contains(hint.OriginalException.Error(), "i/o timeout") { return nil } - 添加 release 版本时注意：Fiber 项目通常无构建产物 hash，可用 Git commit ID（
git rev-parse --short HEAD）或语义化版本号，硬编码"unknown"会让 Source Map 失效
Fiber 的轻量特性让它容易被当成“配个中间件就行”，但 Sentry 的集成深度取决于你是否控制了 panic 冒泡路径、context 生命周期和事件构造时机——这三个地方出问题，上报就会断在某个环节，且很难从日志里看出原因。
