Alpine环境Nginx+uWSGI运行Flask报_cffi_backend模块缺失问题求解

核心根因 #

你遇到的报错本质是uWSGI加载的Python解释器和你安装依赖的Python解释器不匹配：

• 你使用的Docker官方python:3.9-alpine3.14镜像自带的Python路径为/usr/local/bin/python3.9，你执行pip install安装的所有依赖都存放在/usr/local/lib/python3.9/site-packages下，所以直接执行flask run可以正常运行
• 你通过apk add uwsgi-python3安装的uWSGI，默认绑定的是Alpine系统自带的/usr/bin/python3.9，这个Python环境下没有安装你项目所需的cffi、bcrypt等依赖，启动时就会报模块找不到的错误

修复步骤 #

第一步：替换uWSGI安装源 #

卸载Alpine源安装的uWSGI，改用你项目依赖对应的pip安装uWSGI：

# 卸载系统自带的uWSGI
apk del uwsgi uwsgi-python3
# 用当前Python环境的pip安装uWSGI
pip install uwsgi==2.0.20

第二步：修复uWSGI配置 #

在你的uWSGI ini配置文件中添加Python解释器和依赖路径指定，确保加载正确的环境：

# 添加到uwsgi.ini的[Application]区段下
python-bin = /usr/local/bin/python3
pythonpath = /usr/local/lib/python3.9/site-packages

第三步：（可选）重新编译依赖 #

如果执行前两步后仍然报错，说明cffi的预编译包和Alpine系统不兼容，强制重新编译安装cffi和bcrypt：

pip uninstall -y cffi bcrypt
pip install --no-binary :all: cffi bcrypt

验证方法 #

修改完成后先直接在容器内执行uWSGI启动命令，确认无报错后再搭配Nginx运行：

uwsgi --ini /path/to/your/uwsgi.ini

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