Docker部署Flask应用遇ImportError：无法从jinja2导入escape

错误原因 #

Jinja2 3.0及以上版本已移除escape方法，若你的Flask版本低于2.1，或requirements.txt未限制依赖版本兼容性，会导致安装的Jinja2与Flask不匹配，触发该导入错误。

解决方法 #

方法1：锁定兼容的依赖版本 #

修改requirements.txt，明确指定Flask与Jinja2的兼容版本组合：

• 若使用旧版Flask（如2.0.x系列），需限制Jinja2版本低于3.0：

Flask==2.0.3
Jinja2==2.11.3
# 保留其他原有依赖

• 若升级Flask至2.1及以上版本，可兼容Jinja2 3.x：

Flask>=2.1.0
Jinja2>=3.0.0
# 保留其他原有依赖

方法2：修复自定义代码中的导入（若代码手动调用了escape） #

如果你的业务代码里直接从jinja2导入escape，改为从markupsafe导入：

# 替换前
from jinja2 import escape
# 替换后
from markupsafe import escape

方法3：重新构建Docker镜像 #

修改requirements.txt后，执行以下命令清除缓存并重新启动服务：

docker-compose down
docker-compose build --no-cache
docker-compose up

验证要点 #

• 确保requirements.txt中无版本冲突，比如不要同时出现Jinja2>=3.0和Flask<2.1
• 构建镜像时添加--no-cache参数，避免使用缓存的旧依赖包

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