Flask应用依赖包版本冲突排查求助

当前requirements.txt #

aiohttp==3.8.6
aiosignal==1.3.1
async-timeout==4.0.3
attrs==23.1.0
blinker==1.6.3
certifi==2023.7.22
charset-normalizer==3.3.0
click==8.1.7
Flask==1.1.2
Flask-Login==0.6.2
Flask-SQLAlchemy==2.5.1
frozenlist==1.4.0
greenlet==3.0.0
idna==3.4
itsdangerous==2.1.2
Jinja2==3.1.2
MarkupSafe==2.1.3
multidict==6.0.4
openai==0.28.1
psycopg2==2.9.9
python-dotenv==1.0.0
requests==2.31.0
SQLAlchemy==2.0.21
tqdm==4.66.1
typing_extensions==4.8.0
urllib3==2.0.6
Werkzeug==1.0.1
yarl==1.9.2

核心问题分析 #

你遇到的三个导入错误均源于Flask生态组件版本不匹配：

1. Jinja2与Flask版本冲突：Flask 1.1.2依赖Jinja2 <3.0，但当前使用的Jinja2 3.1.2已移除jinja2.escape接口。
2. Flask-SQLAlchemy与SQLAlchemy版本冲突：Flask-SQLAlchemy 2.5.1仅支持SQLAlchemy 1.3~1.4，无法兼容SQLAlchemy 2.0.21，导致内部依赖的_app_ctx_stack调用失败。
3. Werkzeug API过时：werkzeug.urls.url_decode在Werkzeug 1.x中已被弃用，需改用对应替代接口。

解决方案 #

步骤1：清理冲突包 #

执行命令卸载现有冲突组件：

pip uninstall -y Flask Flask-Login Flask-SQLAlchemy Jinja2 MarkupSafe Werkzeug SQLAlchemy

步骤2：安装兼容版本 #

建议在干净的虚拟环境中操作（避免全局依赖污染），安装以下兼容版本：

pip install Flask==1.1.2 Flask-Login==0.6.2 Flask-SQLAlchemy==2.5.1 Jinja2==2.11.3 MarkupSafe==1.1.1 Werkzeug==1.0.1 SQLAlchemy==1.4.49

步骤3：修复代码中的过时API #

若仍存在url_decode导入错误，修改代码：
将

from werkzeug.urls import url_decode

替换为

from werkzeug.urls import url_decode_component

或根据业务逻辑调整为Werkzeug 1.x的可用接口。

兼容版本说明 #

• Flask 1.1.2：与Werkzeug 1.0.1、Jinja2 2.11.3完全兼容。
• Jinja2 2.11.3：保留Flask 1.x所需的escape接口，依赖MarkupSafe 1.1.1避免版本冲突。
• SQLAlchemy 1.4.49：Flask-SQLAlchemy 2.5.1支持的最高稳定版本，规避2.0+的API不兼容问题。

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