为Flask所有路由启用@jwt_required为何触发__init__.py断言错误？

核心原因分析 #

出现这个问题的本质是Flask-JWT-Extended扩展未在路由装饰器解析前完成初始化：当多个路由同时使用@jwt_required时，装饰器的批量解析会触发未初始化的断言检查；单个路由时可能因为初始化流程刚好赶在装饰器检查前完成，侥幸绕过错误。

具体修复步骤 #

1. 修正JWT初始化与蓝图注册的顺序 #

在项目的__init__.py中，必须保证先初始化JWT扩展，再注册users蓝图，示例代码如下：

from flask import Flask
from flask_jwt_extended import JWTManager

# 先创建Flask应用实例
app = Flask(__name__)

# 配置JWT必填密钥（必须设置，否则JWT无法正常工作）
app.config['JWT_SECRET_KEY'] = 'your-secure-secret-key-here'

# 初始化JWT扩展
jwt = JWTManager(app)

# 最后导入并注册蓝图（确保JWT已初始化完成）
from .users import users
app.register_blueprint(users)

2. 检查装饰器调用方式 #

尝试将@jwt_required改为@jwt_required()（带括号的调用形式），确保装饰器被正确实例化：

from flask import Blueprint
from flask_jwt_extended import jwt_required

users = Blueprint('users', __name__)

@users.route('/profile', methods=['GET'])
@jwt_required()
def profile():
    return "<p>Profile</p>"

@users.route('/settings', methods=["PUT"])
@jwt_required()
def settings():
    return "<p>Settings</p>"

3. 确认配置完整性 #

确保Flask应用配置中包含JWT_SECRET_KEY，这是JWT扩展运行的必填项，未配置会导致初始化不完整，触发断言错误。

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