Python FastAPI异常日志记录_集成Sentry实现监控告警-Python教程-PHP中文网

sentry在fastapi中未捕获异常需检查四点：init必须在app = fastapi()前且不在if name == "__main__":内；sentry中间件须最外层；异步任务需手动capture_exception()；422错误需重写exception_handler并上报。

python fastapi异常日志记录_集成sentry实现监控告警

FastAPI启动时Sentry没捕获到异常？检查`init`调用时机和ASGI中间件顺序

FastAPI基于Starlette，Sentry的init必须在ASGI应用实例化前完成，否则HTTPException或未处理的异步异常会被绕过。常见现象是本地抛错有日志，但Sentry后台完全空白。

sentry_sdk.init()要放在app = FastAPI()之前，且不能包裹在if __name__ == "__main__":里（Uvicorn热重载会跳过）
若用了app.add_middleware()自定义中间件，Sentry中间件必须排在最外层——它依赖starlette.middleware.base.BaseHTTPMiddleware，位置靠后会导致部分异常被提前吞掉
确保传入traces_sample_rate=1.0（开发期），否则默认0.1采样率可能让你误判“没上报”

异步任务里的异常不上报？手动捕获并调用`capture_exception`

FastAPI中用BackgroundTasks或asyncio.create_task启动的协程，脱离了请求生命周期，Sentry自动集成无法感知。典型表现：接口返回200，后台任务崩溃，Sentry零记录。

别依赖装饰器或全局钩子，直接在try/except里调用sentry_sdk.capture_exception()
如果用celery，需单独装sentry-sdk[integrations]并初始化Celery集成，FastAPI的init不覆盖Celery上下文
注意capture_exception()必须在异常发生后的同一事件循环中调用，跨await后再捕获会丢失堆栈

422验证错误被忽略？重写`exception_handler`并显式上报

FastAPI默认把RequestValidationError转成422响应，不触发Sentry（它只捕获未处理异常）。结果就是参数校验失败全无告警，线上突然大量422却查不到原因。

Python 3.14.2

Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。

下载

用@app.exception_handler(RequestValidationError)接管，并在handler里调用sentry_sdk.capture_exception(exc)
别直接raise exc——这会触发二次捕获，导致重复上报；改用return JSONResponse(...)返回标准错误体
可加extra字段传入原始请求体：sentry_sdk.set_context("request_body", request_body)，方便排查脏数据

日志里看不到用户ID或请求路径？用`scope`绑定上下文而非全局变量

Sentry默认不带FastAPI请求上下文，所有异常都显示为“unknown transaction”，无法关联用户、路由、trace_id。调试时只能盲猜哪个接口出的问题。

在中间件里用sentry_sdk.set_tag("route", request.url.path)和sentry_sdk.set_user({"id": user_id})（需从token或session提取）
避免在init里设静态user，那会污染所有事件；必须在每次请求的ASGI scope内动态设置
如果用了SQLAlchemy，开启integrations=[SqlalchemyIntegration()]能自动标记慢查询，但要注意连接池复用可能导致tag残留

最易被忽略的是异步上下文隔离——sentry_sdk用thread-local实现，但在async/await链中会丢失。必须用sentry_sdk.is_initialized()确认当前task是否绑定了scope，否则加的tag全无效。