Flask搭配Werkzeug出现cannot import name 'ContextVar'报错

参考Flask开发指南为个人开发的Flask应用生成接口文档时，安装Werkzeug后启动程序抛出如下导入错误：

Traceback (most recent call last):
  File "/home/jnordling/.local/bin/flask", line 5, in <module>
    from flask.cli import main
  File "/home/jnordling/.local/lib/python3.6/site-packages/flask/__init__.py", line 7, in <module>
    from .app import Flask as Flask
  File "/home/jnordling/.local/lib/python3.6/site-packages/flask/app.py", line 19, in <module>
    from werkzeug.local import ContextVar
ImportError: cannot import name 'ContextVar'

• 执行pip install flask安装Flask框架
• 创建基础Flask应用
• 执行pip install flask-restplus安装flask-restplus扩展
• 执行pip install Werkzeug安装Werkzeug依赖
• 创建文档接口端点
• 启动运行应用即触发上述报错

核心问题是依赖版本不兼容：
flask-restplus已经停止维护多年，最高仅支持Werkzeug 0.16.x版本；而默认通过pip install flask安装的新版Flask，要求Werkzeug版本≥2.0，高版本Werkzeug已经将ContextVar从werkzeug.local模块中移除，最终触发导入失败。手动单独安装Werkzeug的操作，直接打破了Flask和扩展之间的版本依赖约束。

二选一即可：

方案1：固定兼容版本（无需修改现有代码） #

卸载现有存在冲突的依赖包，安装经过兼容性验证的版本组合，执行以下命令：

pip uninstall -y flask flask-restplus Werkzeug
pip install flask==1.1.4 Werkzeug==0.16.1 flask-restplus==0.13.0

安装完成后重新启动应用即可正常运行。

方案2：替换为维护中的兼容分叉（推荐长期使用） #

flask-restx是社区接手维护的flask-restplus分叉版本，完全兼容原有API，持续适配新版Flask和Werkzeug，没有历史兼容包袱。
执行以下命令替换依赖：

pip uninstall -y flask-restplus
pip install -U flask flask-restx Werkzeug

将代码中所有flask_restplus的导入语句替换为flask_restx即可，原有接口文档生成逻辑不需要做任何修改，稳定性更好。

注意：后续安装Flask生态相关依赖时，不要单独手动升级Werkzeug、Flask这类基础依赖，安装完成后可以执行pip check命令检查是否存在版本冲突。

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