FastAPI：Swagger Docs的Authorization Header无法全局生效问题问询

核心解决方案：全局配置HTTPBearer依赖 #

你可以通过给FastAPI实例添加全局依赖的方式，让所有端点自动继承Token验证逻辑，同时让Swagger识别并全局应用输入的Authorization头：

1. 定义HTTPBearer认证方案
   先导入所需模块并定义Bearer认证规则：

   from fastapi import FastAPI, Depends
   from fastapi.security import HTTPBearer, HTTPAuthorizationCredentials
   
   # 初始化Bearer认证方案
   oauth2_scheme = HTTPBearer()
   

2. 全局绑定依赖到FastAPI应用
   创建FastAPI实例时，通过dependencies参数注入全局依赖，所有路由（包括子路由、组件路由）都会自动应用这个认证要求：

   app = FastAPI(dependencies=[Depends(oauth2_scheme)])
   

配合已有OIDC中间件的注意事项 #

• 该全局依赖仅负责让Swagger自动携带Token头，不会和你已有的OIDC检查中间件冲突。如果需要在接口中直接获取Token值，可在端点函数中注入认证对象：

  @app.get("/component-route")
  async def component_endpoint(token: HTTPAuthorizationCredentials = Depends(oauth2_scheme)):
      # 通过token.credentials获取Token字符串
      return {"current_token": token.credentials}
  

• 若存在无需Token验证的公开端点，可单独给该端点设置dependencies=[]覆盖全局配置：

  @app.get("/public", dependencies=[])
  async def public_endpoint():
      return {"message": "无需认证即可访问"}
  

验证效果 #

重启FastAPI应用后：

• 打开/docs页面，点击右上角Authorize按钮，按Bearer <你的OIDC Token>格式输入凭证
• 此时所有接口请求都会自动带上Authorization头，包括之前无法传递的子路由、组件路由，调试时能看到请求对象中的头信息正常存在

内容的提问来源于stack exchange，提问作者Masterstack8080