Flask应用启动时须在创建app实例后、注册路由前立即调用sentry_sdk.init()，传入DSN、FlaskIntegration()、environment和release；避免在debug分支或模块导入时初始化，确保PROPAGATE_EXCEPTIONS=True且500处理器不拦截异常后未重抛或手动上报。
Flask 应用启动时如何正确初始化 Sentry SDK
不初始化或初始化时机不对，会导致异常根本不上报。Sentry 必须在 Flask app 实例创建后、但任何路由注册前完成配置，否则中间件链无法捕获早期错误（比如配置加载失败）。
推荐做法是：在创建 app 后立即调用 sentry_sdk.init()，并传入 integrations 显式启用 FlaskIntegration —— 它会自动挂载异常钩子和上下文采集逻辑。
- 必须传
dsn，且确保不是开发环境的空字符串或None；线上环境建议从环境变量读取：os.environ.get("SENTRY_DSN") - 加上
environment="production"和release（如git describe --tags --always结果），否则所有错误都混在一个环境里，无法区分部署版本 - 避免在
if app.debug:分支里初始化 Sentry —— 调试模式关了不代表没异常，线上也可能是debug=False但未配 DSN
为什么 500 页面空白却收不到 Sentry 告警
常见原因是 Flask 的 PROPAGATE_EXCEPTIONS = True 没设，或自定义了 @app.errorhandler(500) 却没重新抛出异常。Sentry 的 FlaskIntegration 依赖 Flask 内部的异常传播机制，一旦被拦截又没手动上报，就彻底丢失。
- 检查是否覆盖了默认 500 处理器：如果写了
@app.errorhandler(500)，必须在函数末尾加raise或显式调用sentry_sdk.capture_exception() - 确认
PROPAGATE_EXCEPTIONS是True（Flask 默认值），若设为False，异常会被吞掉，Sentry 插件收不到 - 异步任务（如 Celery）或后台线程里的异常不会自动上报，需在对应上下文中手动初始化 SDK 或调用
capture_exception()
如何让 Sentry 上报更多调试上下文（如 request body、用户 ID）
Sentry 默认只采样 URL、method、User-Agent，敏感字段（如 password）会被自动过滤，但业务关键字段（如 order_id、user_id）需要主动注入。
立即学习“Python免费学习笔记（深入）”；
- 用
sentry_sdk.set_tag("order_id", request.json.get("order_id"))在请求处理中打标，便于按业务维度筛选事件 - 用
sentry_sdk.set_user({"id": user.id, "email": user.email})关联用户，注意别传明文密码或 token - 避免直接传整个
request.form或request.json：可能含敏感数据，且触发 Sentry 的 payload 截断（默认 1MB 限长）；应只取必要字段 - 若需完整 body，先检查
request.content_length是否超出阈值，再用request.get_data(as_text=True)安全读取
本地调试时误报线上错误怎么办
本地运行时不小心用了线上 DSN，或者 CI/CD 环境变量泄漏，会导致测试异常污染生产监控看板。
- 强制区分环境：在
sentry_sdk.init()中设置environment，并在 Sentry 控制台按 environment 过滤，别依赖 DSN 隔离 - 开发机禁用 Sentry：用
if os.getenv("SENTRY_ENABLED", "false").lower() == "true":包裹初始化逻辑 - CI 构建阶段检查 DSN 是否为空或包含
.ingest.sentry.io—— 本地用http://localhost:8000这类地址会静默失败，看不出问题
最常被忽略的是 release 版本号没更新：同一 release 下所有异常堆栈会聚合，导致新 bug 被旧 issue 掩盖。每次部署必须生成唯一 release 值，哪怕只是 git rev-parse HEAD。
