使用Flask-RESTX与Flask-JWT-Extended时JWT验证失败问题排查

问题场景 #

使用 Flask-RESTX 构建 API，通过 Flask-JWT-Extended 实现 JWT 认证，本地测试正常，但部署到 Docker + Gunicorn 环境后，调用接口时触发错误：

flask_jwt_extended.exceptions.NoAuthorizationError: Missing JWT in headers or cookies (Missing Authorization Header; Missing cookie "access_token_cookie")

排查与解决步骤 #

1. 验证请求头格式正确性 #

• 确认 Postman 中 Authorization 头的格式为 Bearer <你的令牌>，注意 Bearer 与令牌之间必须有空格，这是最容易忽略的细节。
• 如果采用 Cookie 传递令牌，检查请求中是否携带了 access_token_cookie 字段，且令牌值正确。

2. 修正 Gunicorn 请求头转发配置 #

Gunicorn 默认会拦截部分请求头，需在启动命令中添加参数确保头信息能传递到 Flask 应用：

gunicorn --bind 0.0.0.0:5000 --forwarded-allow-ips="*" app:app

--forwarded-allow-ips="*" 允许所有来源的请求头转发，也可指定具体 IP 范围提升安全性。

3. 核对 Flask-JWT-Extended 配置 #

• 检查 JWT_TOKEN_LOCATION 配置是否与你传递令牌的方式匹配：

  # 若用请求头传递
  JWT_TOKEN_LOCATION = ["headers"]
  # 若用Cookie传递
  JWT_TOKEN_LOCATION = ["cookies"]
  # 支持两种方式
  JWT_TOKEN_LOCATION = ["headers", "cookies"]
  

• 确认 JWT_HEADER_NAME 为 Authorization、JWT_HEADER_TYPE 为 Bearer，若修改过这些默认值，需与请求头格式保持一致。

4. 检查装饰器顺序（针对 Flask-RESTX 命名空间） #

参考相关 GitHub Issue 内容：使用 Flask-RESTX 命名空间时，装饰器顺序错误会导致认证失效。需确保 @jwt_required() 装饰器在 @namespace.route() 之后，示例：

@api.route('/input')
class InputReaderView(Resource):
    @jwt_required()
    def get(self):
        # 业务逻辑代码
        pass

5. 排查 Docker 反向代理问题 #

若容器前部署了 Nginx 等反向代理，需在代理配置中显式传递 Authorization 头：

location / {
    proxy_pass http://your-flask-service;
    proxy_set_header Authorization $http_authorization;
    # 其他必要的代理头配置
}

6. 辅助测试建议 #

• 用 curl 命令排除 Postman 配置问题：

  curl -H "Authorization: Bearer <你的令牌>" http://<服务器地址>/api/input
  

• 在 Flask 应用中添加日志，打印请求头信息，确认 Authorization 头是否真的到达应用层：

  from flask import request
  
  @api.route('/test-header')
  def test_header():
      print(request.headers)
      return "OK"
  

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