Flask应用接入Sentry SDK的官方推荐方式是安装sentry-sdk[flask]后，在Flask实例创建后、app.run()前调用sentry_sdk.init()初始化，传入DSN、FlaskIntegration()、environment和release参数，并确保debug=False以捕获500错误。
Flask 应用如何接入 Sentry SDK？
直接装 sentry-sdk 并初始化，别用老的 raven（已弃用）。Sentry 官方推荐方式是通过 init() 在应用启动时注入，而不是手动捕获异常再上报。
- 安装：
pip install sentry-sdk[flask] - 初始化必须在
Flask实例创建后、app.run()前执行，否则中间件注册失败 -
dsn必须从 Sentry 项目设置页复制完整 URL，漏掉https://或拼错@后面的域名会导致静默失败 - 建议加上
environment="production"和release="v1.2.0"，否则所有错误都堆在dev环境里，无法按环境/版本过滤
示例片段：
import sentry_sdk
from sentry_sdk.integrations.flask import FlaskIntegration
from flask import Flask
app = Flask(__name__)
sentry_sdk.init(
dsn="https://xxx@o123456.ingest.sentry.io/1234567",
integrations=[FlaskIntegration()],
environment="production",
release="v1.2.0"
)
为什么 500 错误没出现在 Sentry？
常见原因是 Flask 的 debug=True 模式下，Sentry 默认不捕获异常——它认为你在本地调试，不想污染线上数据。这不是 bug，是设计行为。
- 开发时想测试上报，加参数
debug=True同时设send_default_pii=True不够，关键要显式启用：在init()中加debug=True（SDK 级 debug）或临时关闭 Flask 的 debug 模式 - 检查是否被
try/except吞掉了异常：Sentry 只捕获未被处理的异常，如果代码里写了except Exception: pass，错误根本不会冒泡到 Sentry - 确认
FlaskIntegration()已传入integrations列表，漏掉这个集成会导致路由层异常不被捕获 - HTTP 4xx 错误默认不上报，如需监控客户端错误（比如 API 调用参数错），得手动调用
sentry_sdk.capture_message("Invalid JSON", level="warning")
如何让 Sentry 记录用户 ID 和请求上下文？
默认只传异常堆栈和基础 request info，敏感字段（如 user_id、email）需要主动绑定，且必须在异常发生前完成绑定，否则上下文丢失。
立即学习“Python免费学习笔记（深入）”；
- 在请求开始时用
sentry_sdk.set_user({"id": user_id, "email": email})，推荐放在@app.before_request钩子里 - 避免在异步任务（如 Celery）中复用同一 scope，每个任务应调用
sentry_sdk.push_scope()+with块隔离上下文 - 自定义 tag 用
sentry_sdk.set_tag("api_version", "v2")，比写进 message 字段更利于后续筛选 - 不要把密码、token 等敏感字段塞进
set_context()，Sentry 控制台可能明文显示，且违反 GDPR
部署后错误不实时上报，怎么排查？
最常卡在 DNS 解析、防火墙或代理配置上。Sentry SDK 默认走 HTTPS 上报，但企业内网常拦截或重定向流量。
- 先验证网络连通性：
curl -v https://o123456.ingest.sentry.io/api/1234567/store/（替换为你的 DSN 域名），看是否返回 401 或超时 - 若服务器走代理，必须在
init()中传http_proxy和https_proxy参数，SDK 不读系统环境变量 - 检查日志是否有
sentry_sdk.transport.HttpTransport相关 warning，比如 “Failed to submit event” 后跟 connection reset，基本就是网络问题 - 使用
traces_sample_rate=1.0开启全量性能追踪时，注意会显著增加上报体积，生产环境建议设为0.1或更低
真正麻烦的是多进程部署（gunicorn + worker > 1）时，Sentry 的全局 client 初始化冲突——每个 worker 进程都要独立 init，不能只在主进程做一次。
