Alpine因musl libc与glibc不兼容，导致cryptography、psycopg2等C扩展构建失败或运行时报libssl.so.3缺失；推荐Debian系build+slim-bookworm run的多阶段组合。
直接用 python:3.12.4-slim-bookworm 就比 python:3.12 小 60%，再加多阶段构建，能再砍掉 30%–50% 体积；但 Alpine 不是万能解药，Django 项目里带 cryptography、psycopg2 这类 C 扩展时，Alpine 构建失败率高，得换策略。
为什么 Alpine 在 Django 多阶段构建里容易翻车
Alpine 使用 musl libc 而非 glibc，很多 Python 包的预编译 wheel 不兼容 musl，比如 psycopg2-binary 从 2.9 开始就不再提供 Alpine wheel，cryptography 也常因 OpenSSL 版本不匹配报错。你看到的典型错误是：
ERROR: Could not find a version that satisfies the requirement cryptography==41.0.7
或者更隐蔽的运行时报错：
ImportError: Error loading shared library libssl.so.3: No such file or directory
- 不是所有包都支持 Alpine，尤其带二进制依赖的包要查 PyPI 文件列表 是否有
musllinux标签 -
pip install --no-cache-dir在 Alpine 上仍可能留下构建缓存（如/tmp/pip-build-*），必须显式清理 - Alpine 的
apk add安装的系统级依赖（如postgresql-dev、openssl-dev）不能留在最终镜像里，否则白瘦身
Dockerfile 多阶段写法：Build 阶段用完整镜像，Run 阶段切 slim
推荐组合：python:3.12-bullseye（Debian）做 build 阶段，python:3.12-slim-bookworm 做 run 阶段。既避开 Alpine 兼容坑，又比全量镜像小一半以上。关键点在 COPY 精确路径和避免复制整个 /usr/local/lib/python3.12/site-packages：
立即学习“Python免费学习笔记（深入）”；
FROM python:3.12-bullseye AS builder WORKDIR /app COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt COPY . . <p>FROM python:3.12-slim-bookworm WORKDIR /app</p><h1>只复制 site-packages 下已安装的包，不复制构建残留</h1><p>COPY --from=builder /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages COPY --from=builder /app/manage.py /app/ COPY --from=builder /app/myproject/ /app/myproject/ COPY --from=builder /app/static/ /app/static/ CMD ["gunicorn", "--bind", "0.0.0.0:8000", "myproject.wsgi:application"]
- 不要用
COPY --from=builder /app /app，会把__pycache__、.git、venv全拖进来 -
requirements.txt中避免混用psycopg2和psycopg2-binary，后者在 slim 镜像里可能缺编译工具 - 如果用了
whitenoise或需要 collectstatic，把这步放到 builder 阶段执行，再 COPYstaticfiles/
buildkit + .dockerignore 是隐形加速器
默认 Docker 构建会把当前目录所有文件发给 daemon，哪怕你只改了 settings.py。开启 buildkit 后，Docker 会按需传输，配合 .dockerignore 能省下大量时间：
# .dockerignore .git __pycache__ *.pyc *.pyo *.pyd .Python env/ venv/ .dockerignore .gitignore README.md requirements.txt
- 务必忽略
requirements.txt—— 否则每次改它都会让 builder 阶段的 layer 缓存失效 - 启用 buildkit：运行前加
export DOCKER_BUILDKIT=1，或写进/etc/docker/daemon.json - buildkit 下
RUN pip install的 layer 会自动去重，多个 RUN 指令装同一堆包也不会重复下载
真正难的不是写对多阶段语法，而是判断哪些文件该从 builder 复制、哪些该重建——比如 staticfiles/ 要不要在 run 阶段重新 collectstatic？取决于你是否挂载了 volume；manage.py 里的调试逻辑要不要删？这些细节没统一标准，得看部署场景。
