Flask-Smorest蓝图中Authorization请求头在Swagger UI不生效问题

Flask-Smorest 针对Swagger UI的认证头传递有专门的OpenAPI安全定义机制，你之前用普通参数声明的方式无法让Swagger UI正确识别并处理Authorization头，以下是正确的配置步骤：

1. 定义认证安全方案 #

在你的蓝图中，使用@blp.security_scheme定义Bearer类型的认证方案（如果是其他认证类型，比如Basic Auth，可调整对应参数）：

from flask_smorest import Blueprint
from flask import request

blp = Blueprint("users", __name__, description="用户操作接口")

# 定义Bearer认证的安全方案
blp.security_scheme(
    "BearerAuth",
    type="http",
    scheme="bearer",
    bearerFormat="JWT"  # 可选，如果你用的是JWT令牌
)

2. 在目标路由上关联安全方案 #

在/me路由的文档装饰器中，通过security参数关联刚才定义的安全方案：

@blp.route("/me")
@blp.doc(security=[{"BearerAuth": []}])
def get_current_user():
    # 从请求头获取Authorization令牌
    auth_header = request.headers.get("Authorization")
    if not auth_header:
        return {"error": "未提供认证令牌"}, 401
    
    # 这里写你的令牌解析和用户信息获取逻辑
    user_info = parse_token_and_get_user(auth_header)
    return {"user": user_info}

3. 验证效果 #

启动应用后打开Swagger UI，你会看到界面顶部出现Authorize按钮。点击按钮后，输入你的Bearer令牌（格式为Bearer <你的token>），保存后再调用/me接口，Swagger UI会自动在请求中携带Authorization头。

为什么之前的方法无效？ #

• @blp.doc(parameters=[body])是添加普通请求头参数，Swagger UI不会将其识别为认证专用头，因此不会提供专门的认证输入界面，手动输入也可能无法正确传递。
• @blp.arguments(AuthSchema, location='headers')用于解析请求头数据，但同样不会触发Swagger UI的认证机制，只是普通的参数校验。

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