sentry可自动捕获flask未处理异常并注入完整上下文，关键在于：必须用sentry-sdk[flask]、显式传入flaskintegration()、在app创建后且app.run()前初始化、设environment为"production"或"staging"，避免开发环境误报，并手动绑定用户等动态上下文。
Flask 应用上线后，未捕获的异常默认只打到日志或直接 500，根本没法及时知道用户遇到了什么错误。Sentry 能自动捕获 Exception、未处理的 500、甚至前端 JS 错误，但直接装官方 SDK 容易漏掉 Flask 的上下文（比如 request ID、URL、查询参数），导致排查时“知道报错了，但不知道谁、在哪、怎么触发的”。
安装 sentry-sdk 并初始化 Flask 集成
别用老的 raven，它已废弃；必须用 sentry-sdk，它原生支持 Flask 中间件和上下文自动注入。
执行：
pip install sentry-sdk[flask]
在 Flask app 创建后、app.run() 前初始化：
import sentry_sdk from sentry_sdk.integrations.flask import FlaskIntegration <p>sentry_sdk.init( dsn="<a href="https://www.php.cn/link/35856571321788e2cfb267bccef93f07">https://www.php.cn/link/35856571321788e2cfb267bccef93f07</a>", integrations=[FlaskIntegration()], traces_sample_rate=0.1, # 可选：采样率，避免上报过多性能事件 environment="production", # 强烈建议设为 "staging" 或 "production" )</p>
注意：FlaskIntegration() 必须显式传入 integrations 列表，否则 request 数据不会自动附加。
确保 500 错误被 Sentry 捕获（而非被 Flask 默认 handler 吞掉）
Flask 默认会把未处理异常转成 500 响应，但不主动上报——sentry-sdk 依赖 FlaskIntegration 的中间件钩子来拦截，所以必须让异常“冒泡”出去，不能提前 try/except 吞掉。
常见错误写法：
@app.route("/api/data")
def get_data():
try:
return db.query(...) # 这里抛出异常
except Exception as e:
logger.error("query failed") # Sentry 不会收到这个异常！
return {"error": "internal"}, 500
正确做法是只捕获你明确要处理的异常类型，其他让 Flask 自己抛：
- 用
except ValueError:、except requests.Timeout:等具体类型兜底 - 对所有
Exception的通用 catch，仅用于日志记录 +raise继续向上抛 - 或者干脆不写
try/except，靠全局@app.errorhandler(500)统一处理并手动调用sentry_sdk.capture_exception()
手动上报业务逻辑异常（比如校验失败、第三方服务不可用）
Sentry 默认只捕获未处理异常，但有些场景你希望主动上报——比如调用支付网关返回 "INVALID_SIGNATURE"，这不是 Python 异常，但属于关键业务失败。
用 sentry_sdk.capture_message() 或 sentry_sdk.capture_exception()：
import sentry_sdk
<h1>上报一条带上下文的消息</h1><p>sentry_sdk.capture_message(
"Payment gateway returned INVALID_SIGNATURE",
level="warning",
extra={"order_id": order.id, "gateway": "alipay"}
)</p><h1>或者包装一个业务异常再上报</h1><p>class PaymentGatewayError(Exception):
pass</p><p>try:
result = call_alipay_api(...)
except Exception as e:
sentry_sdk.capture_exception(PaymentGatewayError(f"Alipay failed: {e}"))
raise</p>
注意：capture_message() 不会附带堆栈，适合非异常场景；capture_exception() 会抓当前 traceback，适合包装后重抛。
本地开发时禁用 Sentry 避免污染数据
本地 debug=True 时，任何 print()、小 typo 都会发到 Sentry，干扰真实问题。最稳妥的方式是根据环境变量控制初始化：
import os
if os.environ.get("SENTRY_DSN"):
sentry_sdk.init(
dsn=os.environ["SENTRY_DSN"],
integrations=[FlaskIntegration()],
environment=os.environ.get("ENVIRONMENT", "development"),
)
然后启动时：
SENTRY_DSN=https://www.php.cn/link/35856571321788e2cfb267bccef93f07 ENVIRONMENT=staging python app.py
更保险的做法是：只在 environment != "development" 时 init，因为 Flask 的 debug=True 通常只出现在开发环境，但生产部署可能用 Gunicorn + debug=False，此时仍需 Sentry。
真正容易被忽略的是上下文丢失——比如你在 before_request 里设置了用户 ID，但没通过 sentry_sdk.set_tag() 或 sentry_sdk.set_user() 显式传给 Sentry，那报错时就看不到是哪个用户触发的。这类“活上下文”必须手动绑定，SDK 不会自动扫描全局变量或 Flask g 对象。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
