FastAPI中间件无法捕获路由抛出的HTTPException问题咨询

你好呀！这个问题我之前折腾过好一会儿，终于搞懂原因了，给你慢慢说：

为什么中间件抓不到HTTPException？ #

其实核心原因是FastAPI（准确说是它底层的Starlette框架）会自动处理路由里抛出的HTTPException——当你的路由函数抛出HTTPException时，Starlette的内置异常处理器会立刻接手，把这个异常直接转换成对应的HTTP响应（比如400状态码的JSON响应），而不是让这个异常继续“冒泡”到你的HTTP中间件的except块里。

所以你的中间件里调用await call_next(request)的时候，拿到的已经是一个处理好的400响应对象了，而不是一个被抛出的异常，自然就触发不到except HTTPException的分支啦。而其他非HTTPException的异常，Starlette不会自动处理，才会顺着调用栈跑到中间件的except Exception里被捕获。

那该怎么处理HTTPException呢？ #

给你两个常用的解决方案，看你需求选：

方案1：用自定义异常处理器（推荐）

FastAPI专门提供了异常处理器的机制来处理这类框架级的异常，比中间件更合适。你可以直接定义一个针对HTTPException的处理器，比如：

from fastapi import FastAPI, HTTPException, Request
from fastapi.responses import JSONResponse

app = FastAPI()

# 自定义HTTPException处理器
@app.exception_handler(HTTPException)
async def custom_http_exception_handler(request: Request, exc: HTTPException):
    # 这里可以加你的自定义逻辑，比如打日志、修改响应格式
    print(f"捕获到HTTP异常：状态码{exc.status_code}，详情{exc.detail}")
    return JSONResponse(
        status_code=exc.status_code,
        content={"detail": exc.detail, "note": "这个响应是我们自定义处理器返回的"}
    )

# 剩下的路由、中间件注册逻辑不变
app.include_router(v1.default.worker)
app.middleware("http")(http_global_exception_middleware)

这个处理器会接管所有路由抛出的HTTPException，你可以在这里统一做日志、修改响应结构等操作。

方案2：如果一定要用中间件，换个思路处理

要是你非得在中间件里处理这类错误，那只能通过检查响应的状态码来判断——因为异常已经被转成响应了，比如：

async def http_global_exception_middleware(request: Request, call_next: Callable) -> Response:
    try:
        response = await call_next(request)
        # 检查响应状态码，判断是否是HTTPException对应的错误响应
        if 400 <= response.status_code < 600:
            # 这里可以做你想做的处理，比如打日志
            logger.info(f"收到错误响应：{response.status_code}，路径{request.url.path}")
        return response
    except Exception as e:
        logger.critical(e)
        raise HTTPException(
            status_code=500,
            detail=str(e)
        )

不过这种方式没法直接拿到原来的HTTPException对象，只能基于响应做处理，适合只需要日志或者简单修改响应的场景。

另外提一嘴，你注册中间件的顺序是对的，和这个问题无关，不用调整~

备注：内容来源于stack exchange，提问作者Unknown.Vagrant