flask生产环境不能设debug=true，因会启用交互式调试器导致安全风险；sentry需显式初始化并传flaskintegration()才能捕获完整上下文异常，且须注意异步任务、全局异常钩子覆盖等导致丢失的场景。
Flask生产环境为什么不能直接用debug=True
因为debug=True会启用Werkzeug重载器和交互式调试器，暴露敏感变量、执行任意代码，线上一旦被扫描到/console或触发异常页面，等于把服务器控制权交出去。真实生产环境（尤其是Nginx + Gunicorn部署）必须关掉它，但关掉后错误就“静默”了——HTTP 500返回给用户，日志可能只记一行Internal Server Error，根本看不出哪行代码崩了。
如何让Sentry捕获Flask未处理异常
Sentry SDK默认支持Flask，但需要显式初始化并注册中间件。关键是两点：不干扰原有请求生命周期，且能拿到完整的上下文（如request、user、session）。常见错误是只调用sentry_sdk.init()却没传integrations，导致路由参数、表单数据、headers全丢。
- 安装：
pip install sentry-sdk[flask] - 初始化必须放在Flask应用创建之后、
app.run()之前，且environment要明确设为"production"（否则默认"dev"，部分规则不生效） - 务必传入
FlaskIntegration()：sentry_sdk.init(dsn="...", integrations=[FlaskIntegration()])，否则request.url、request.headers等字段为空 - 避免在
before_first_request里初始化——Gunicorn多worker下会重复注册，引发警告甚至丢失事件
为什么有些异常Sentry收不到？检查这三处
不是所有报错都会自动上报。Sentry只捕获未被try/except吞掉的顶层异常，且依赖Flask的teardown_request钩子做最后flush。以下情况会导致丢失：
-
sys.excepthook被覆盖（比如用了loguru全局异常处理器但没调用sentry_sdk.capture_exception()） - 异步任务（Celery、threading）里的异常：需在任务函数内手动调用
sentry_sdk.capture_exception()，SDK不会自动跨线程传播 - Gunicorn worker timeout或OOM被强制kill：进程直接终止，来不及发事件。此时要依赖系统日志+
supervisord或systemd的crash记录作兜底
堆栈里看不到本地变量值？这是故意的
Sentry默认禁用locals采集，防止密码、token、数据库连接串等敏感信息泄露。如果你确认环境安全且需要调试，可在初始化时加：send_default_pii=True，但必须配合before_send过滤器清理敏感字段：
def filter_sensitive(event, hint):
if 'exc_info' in hint:
exc_type, exc_value, tb = hint['exc_info']
if 'password' in str(exc_value).lower():
event['extra'] = {'reason': 'password-related error'}
return None
return event
sentry_sdk.init(
dsn="...",
before_send=filter_sensitive,
send_default_pii=True
)
注意send_default_pii=True本身不等于“显示所有变量”，它只是允许SDK读取request.form、request.args这类结构化数据；局部变量仍需在except块里显式传入extra字段才能上报。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
