为什么要用 JWT 认证中间件？

约 931 字大约 3 分钟

2025-06-15

在构建现代 Web 应用时，安全认证是不可或缺的一环。今天，让我们一起来看看 fba 项目中的 JWT 认证中间件： backend/middleware/jwt_auth_middleware.py 的实现，这将是我们在企业级项目中可应用的最佳实践

它解决了什么问题？

如果你正在开发一个需要用户登录的 API 服务，你需要：

验证用户身份
保护敏感接口
在请求间保持用户状态
优雅地处理认证失败
......

传统方案往往需要你在每个接口中重复编写认证逻辑，或者使用装饰器来包装路由函数，而我们的 JWT 中间件则提供了一种更优雅的集成方式：一次配置，全局生效

如何使用它？

例如在 fba 中，我们提供了中间件的统一注册入口：

def register_middleware(app: FastAPI) -> None:
    # ...其他中间件
    app.add_middleware(
        AuthenticationMiddleware,  # 来自 starlette 的认证中间件
        backend=JwtAuthMiddleware(),  # 重写为自定义中间件
        on_error=JwtAuthMiddleware.auth_exception_handler,  # 重写为自定义错误
    )

然后在你的路由函数中，就可以直接通过 request.user 获取当前登录用户的信息，如下所示：

@router.get("/profile")
async def get_profile(request: Request):
    # 用户信息已经由中间件注入到请求对象中
    current_user = request.user
    return {"user": current_user}

我们可以看到，既没有繁琐的依赖注入，也没有重复的认证代码，一切都变得如此简洁

与 FastAPI 官方实现的不同之处

FastAPI 官方推荐使用 OAuth2PasswordBearer 和依赖注入系统来实现 JWT 认证

oauth2_scheme = OAuth2PasswordBearer(tokenUrl="token")

@router.get("/users/me")
async def get_profile(current_user: User = Depends(get_current_user)):
    return current_user