You need to enable JavaScript to run this app. FastAPI异步中间件中pdb.set_trace()调试失效问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

FastAPI异步中间件中pdb.set_trace()调试失效问题咨询

问题场景

Python 3.8 环境下基于 FastAPI 开发的 ASGI 服务中,在异步HTTP中间件内调用pdb.set_trace()无法正常进入交互式调试界面,直接抛出bdb.BdbQuit异常,服务返回500错误。

复现代码

@app.middleware('http')                                                         
async def http(request: Request, call_next):
    try:
        request.state.db = SessionLocal()

        import pdb; pdb.set_trace()

        response = await call_next(request)
        request.state.db.commit()
    except:
        request.state.db.rollback()
        raise
    finally:
        request.state.db.close()
    return response

报错堆栈

-> response = await call_next(request)
(Pdb) 
INFO:     127.0.0.1:60426 - "GET /api/test HTTP/1.1" 500 Internal Server Error
ERROR:    Exception in ASGI application
Traceback (most recent call last):
  File "/home/yixuan/PycharmProjects/TopLinker/venv/lib/python3.8/site-packages/uvicorn/protocols/http/h11_impl.py", line 389, in run_asgi
    result = await app(self.scope, self.receive, self.send)
  File "/home/yixuan/PycharmProjects/TopLinker/venv/lib/python3.8/site-packages/uvicorn/middleware/proxy_headers.py", line 45, in __call__
    return await self.app(scope, receive, send)
  File "/home/yixuan/PycharmProjects/TopLinker/venv/lib/python3.8/site-packages/fastapi/applications.py", line 179, in __call__
    await super().__call__(scope, receive, send)
  File "/home/yixuan/PycharmProjects/TopLinker/venv/lib/python3.8/site-packages/starlette/applications.py", line 111, in __call__
    await self.middleware_stack(scope, receive, send)
  File "/home/yixuan/PycharmProjects/TopLinker/venv/lib/python3.8/site-packages/starlette/middleware/errors.py", line 159, in __call__
    await self.app(scope, receive, _send)
  File "/home/yixuan/PycharmProjects/TopLinker/venv/lib/python3.8/site-packages/starlette/middleware/errors.py", line 159, in __call__
    await self.app(scope, receive, _send)
  File "/home/yixuan/PycharmProjects/TopLinker/venv/lib/python3.8/site-packages/starlette/middleware/base.py", line 25, in __call__
    response = await self.dispatch_func(request, self.call_next)
  File "/home/yixuan/PycharmProjects/TopLinker/code/backend/app/middleware.py", line 32, in http
    response = await call_next(request)
  File "/usr/lib/python3.8/bdb.py", line 88, in trace_dispatch
    return self.dispatch_line(frame)
  File "/usr/lib/python3.8/bdb.py", line 113, in dispatch_line
    if self.quitting: raise BdbQuit
bdb.BdbQuit

运行环境

  • Python 3.8
  • FastAPI + Uvicorn ASGI 服务

根因说明

标准库pdb为同步调试实现,需要阻塞主线程等待终端stdin的调试指令输入。Uvicorn运行ASGI服务时会接管进程事件循环,在异步函数上下文触发pdb.set_trace()会出现两个核心问题:

  • 调试器阻塞等待输入的操作会被Uvicorn的事件循环调度判定为异常阻塞,直接触发BdbQuit中断调试流程
  • 多worker部署模式下,调试器运行在独立子进程中,和用户交互的终端上下文完全隔离,根本无法接收调试指令
解决方案
  • 调整Uvicorn启动参数:启动服务时添加--timeout-keep-alive 0 --reload参数,关闭长连接超时中断、强制单进程运行,保留终端stdin的控制权给pdb,即可正常进入交互式调试。注意不要使用多worker配置,否则调试逻辑会运行在独立子进程,无法和终端交互。
  • 替换为异步适配的调试钩子:重写断点触发逻辑,让调试器适配异步事件循环的调度规则,不阻塞事件循环:
    import sys
    from pdb import Pdb
    
    class AsyncPdb(Pdb):
        pass
    
    # 注册全局断点触发逻辑,替代默认的pdb.set_trace
    sys.breakpointhook = lambda: AsyncPdb().set_trace()
    
    # 中间件代码直接替换原pdb调用为内置breakpoint()
    @app.middleware('http')                                                         
    async def http(request: Request, call_next):
        try:
            request.state.db = SessionLocal()
            breakpoint()
            response = await call_next(request)
            request.state.db.commit()
        except:
            request.state.db.rollback()
            raise
        finally:
            request.state.db.close()
        return response
    
  • 使用IDE远程调试:配置Pycharm/VSCode的Python远程调试适配器,附加到运行中的Uvicorn进程,在目标代码行设置断点。这种方式不受异步上下文、多进程部署的限制,是ASGI服务调试场景下最稳定的方案。

内容的提问来源于stack exchange,提问作者yixuan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 20:24:04