Sentry Go SDK 初始化必须在main()中显式调用sentry.Init()，传入正确DSN（取自Client Keys页面的完整URL）和Environment（如production-auth-service），避免在init()中调用导致panic或配置未就绪。
Go项目里怎么填Sentry的环境和Token
必须在初始化 sentry.Init() 时传入 Environment 和 Dsn，硬编码或从环境变量读取都行，但不能漏、不能拼错。
常见错误是把 DSN 写成 Sentry 项目的「Client Keys (DSN)」页面里带 https:// 的完整 URL，其实 Go SDK 只认原始 DSN 字符串（形如 https://abc123@o123456.ingest.sentry.io/1234567），这个没问题；但如果你误贴了「Security Headers」里的 SENTRY_AUTH_TOKEN 或项目设置里的 API Key，上报会静默失败——没报错，但 Sentry 后台收不到任何事件。
-
Dsn必须是项目「Client Keys (DSN)」页复制的完整字符串，开头带https:// -
Environment推荐用os.Getenv("SENTRY_ENV")动态读取，开发填development，线上填production，避免打包时写死 - 别把
Auth Token当 DSN 用——它只用于 API 调用（比如发 release），不参与前端或服务端错误采集
为什么本地开发时 Sentry 不上报错误
大概率是 Environment 值触发了默认过滤，或者 DSN 被空字符串/空白字符污染。
Go SDK 默认不会上报 Environment == "development" 的事件（除非显式关掉过滤）。这不是 bug，是设计行为。另外，如果 os.Getenv("SENTRY_DSN") 返回空，sentry.Init() 会静默跳过初始化——整个 SDK 失效，连日志都不打，非常难察觉。
- 启动时加一行
log.Printf("Sentry DSN: %q", os.Getenv("SENTRY_DSN"))确认变量是否真被读到 - 强制启用开发环境上报：在
sentry.Init()中加IgnoreErrors: []string{}和BeforeSend: func(event *sentry.Event, hint *sentry.EventHint) *sentry.Event { return event }，先绕过所有过滤 - 检查
.env文件或 shell 启动命令里有没有多余的空格，比如SENTRY_DSN=" https://..."开头有空格就会失效
多个微服务共用一个 Sentry 项目时怎么区分环境
靠 Environment + Release 组合区分，不是靠不同 DSN。
一个 Sentry 项目可以管理几十个服务，关键在上报时带上准确的 Environment（如 staging-api、production-worker）和语义化 Release（如 v1.2.3-api）。如果全写成 production，你在 Issues 列表里根本分不清是哪个服务崩的。
-
Environment建议格式：${ENV}-${SERVICE_NAME}，例如production-auth-service -
Release最好从构建时注入，比如go build -ldflags "-X main.release=v1.2.3-$(git rev-parse --short HEAD)"，再在sentry.Init()里传进去 - 避免用时间戳当
Release（如20240520），Sentry 的版本对比功能会失效
init() 里调用 sentry.Init() 有哪些坑
Go 的 init() 函数执行顺序不可控，如果依赖其他包（比如配置加载器）还没初始化完，sentry.Init() 就可能拿到空 DSN 或错误环境名。
更麻烦的是，一旦 sentry.Init() 失败（比如 DSN 格式错），它会 panic 并终止进程——而这个 panic 发生在 init() 阶段，连 recover() 都捕获不到。
- 不要在
init()里调用sentry.Init()，改到main()开头，确保配置已就绪 - 加一层判断：
if dsn := os.Getenv("SENTRY_DSN"); dsn != "" { sentry.Init(...) }，避免空 DSN 导致 panic - 如果必须提前初始化（比如想捕获
main()之前的 panic），至少用defer sentry.Flush(2*time.Second)包裹整个main()，否则进程退出太快，错误可能发不出去
最常被忽略的是：Sentry Go SDK 默认不捕获 goroutine panic，只抓 main 协程的。如果业务逻辑跑在独立 goroutine 里崩了，得手动用 recover() 捕获后调 sentry.CaptureException() 上报——这点和 Node.js 或 Python SDK 完全不同。
