python:3.12-alpine镜像跨Windows/Debian表现异常及解决方法咨询

问题根源 #

你使用的python:3.12-alpine镜像为追求极致精简，默认未包含C编译器（gcc）及必要构建依赖，而你的依赖中cryptography、bcrypt等包需要编译C扩展，因此安装流程失败。

高效解决方法 #

方法1：修改Alpine镜像的Dockerfile，补充构建依赖 #

在安装pip依赖前，先安装Alpine的构建工具链，完成后可清理缓存缩小镜像体积：

FROM python:3.12-alpine
LABEL authors="Raphael2b3"

# 安装编译所需依赖：gcc、musl开发库、libffi开发库
RUN apk add --no-cache gcc musl-dev libffi-dev

ADD requirements.txt ./

RUN pip install --upgrade pip
RUN pip install -r requirements.txt

# 移除构建依赖，减小镜像体积
RUN apk del gcc musl-dev libffi-dev

RUN rm -f ./requirements.txt

ADD . ./src
WORKDIR ./src

CMD ["python", "main.py"]

方法2：换用Debian Slim基础镜像（更省心） #

Debian的python:3.12-slim镜像体积略大于Alpine，但针对树莓派4的arm64架构提供了大量预编译wheel包，无需手动安装编译器，直接安装依赖即可：

FROM python:3.12-slim
LABEL authors="Raphael2b3"

ADD requirements.txt ./

RUN pip install --upgrade pip
RUN pip install -r requirements.txt

RUN rm -f ./requirements.txt

ADD . ./src
WORKDIR ./src

CMD ["python", "main.py"]

是否需要上报？ #

不需要。该问题是Alpine镜像的设计特性（默认不含构建工具以精简体积）导致的正常场景问题，不属于软件bug或兼容性故障，调整Dockerfile即可解决。

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