运行Python项目Dockerfile时提示No module named 'M2Crypto'错误

这个报错是容器内Python环境未正确安装M2Crypto库导致的，核心原因有两个：

• 你使用的python:3.8-slim-buster是精简裁剪版基础镜像，默认没有预装GCC编译器、OpenSSL开发库、SWIG这些M2Crypto安装必需的系统组件，直接通过pip安装M2Crypto会触发编译失败，很多人构建时没注意pip的报错日志，误以为依赖装全了
• 部分低版本的passbook库没有将M2Crypto声明为强制依赖，执行pip install passbook时不会自动拉取安装M2Crypto，哪怕系统依赖齐全也不会装这个包

按以下步骤调整配置即可解决：

1. 修改Dockerfile，在执行pip安装依赖前先预装M2Crypto需要的系统依赖，修正后的完整配置如下：

FROM python:3.8-slim-buster
# 安装M2Crypto依赖的系统组件，安装完成后清理apt缓存减小镜像体积
RUN apt-get update && apt-get install -y --no-install-recommends \
    gcc \
    libssl-dev \
    swig \
    && rm -rf /var/lib/apt/lists/*
WORKDIR /app
COPY requirements.txt .
# 安装Python依赖，--no-cache-dir参数避免pip缓存冗余文件
RUN pip3 install --no-cache-dir M2Crypto
RUN pip3 install --no-cache-dir -r requirements.txt
COPY . .
ENTRYPOINT [ "python3" ]    
CMD [ "main.py" ]

2. 打开项目根目录的requirements.txt文件，确认文件内添加了M2Crypto的依赖声明，适配Python3.8的稳定版本可写为M2Crypto==0.38.0
3. 重新构建镜像，构建时加上--no-cache参数跳过旧的错误构建缓存，执行命令：
   docker build --no-cache -t your-app-name .
   构建完成后正常启动容器即可。

补充说明：如果本地开发环境是Windows或macOS，安装M2Crypto时会直接下载对应平台的预编译二进制包，不需要手动装编译依赖，这也是本地运行正常、容器内启动报错的最常见诱因。

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