如何解决flask_jwt_extended导入时的DecodeError导入错误？

排查及解决步骤 #

1. 核对PyJWT与flask_jwt_extended版本兼容性 #

flask_jwt_extended对PyJWT有明确的版本依赖，版本不匹配会引发导入错误：

• 先查看已安装的flask-jwt-extended版本：

  pip show flask-jwt-extended
  

• 根据版本对应关系安装匹配的PyJWT，例如flask-jwt-extended 4.x系列需搭配PyJWT 2.x版本：

  pip install pyjwt==2.8.0
  

2. 彻底清理冲突的JWT相关包 #

残留的旧包或冲突依赖会干扰正常导入：

• 卸载所有JWT相关包：

  pip uninstall -y jwt pyjwt
  

• 重新安装指定版本的依赖：

  pip install pyjwt==2.8.0 flask-jwt-extended
  

3. 确认虚拟环境正确性 #

如果使用虚拟环境，确保激活的是当前项目的环境，避免全局包与虚拟环境包冲突：

• 激活虚拟环境（以venv为例）：

  # Windows系统
  venv\Scripts\activate
  # Linux/macOS系统
  source venv/bin/activate
  

• 激活后重新安装依赖包。

4. 排查本地文件命名冲突 #

项目目录中若存在名为jwt.py的文件或jwt文件夹，会导致Python优先导入本地文件而非PyJWT库：

• 重命名项目内的jwt.py或jwt文件夹；
• 删除项目目录下的__pycache__缓存文件夹。

5. 升级flask_jwt_extended到稳定版 #

旧版本的flask_jwt_extended可能存在已知兼容性问题，升级到最新稳定版：

pip install --upgrade flask-jwt-extended

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