选用 alpine 镜像需规避 musl 兼容问题，优先用 apk 安装预编译包；通过多阶段构建、精确 copy、强制清理缓存与冗余文件，并在不兼容时退选 debian:slim，兼顾体积与稳定性。
直接换用 python:3.11-alpine 并不能自动得到小镜像——Alpine 本身轻，但 pip 安装过程容易悄悄塞进大量冗余内容。真正瘦身要靠组合策略：选对基础镜像只是起点，关键在构建方式和清理动作。
用对 Alpine 镜像，避开 musl 兼容陷阱
Alpine 使用 musl libc，而很多 PyPI 包的预编译 wheel 是为 glibc（如 Ubuntu/Debian）打包的。pip 检测到不匹配，就会退回到源码编译，留下临时文件、调试符号和未清理的 .so 库。
- 先运行
pip debug --verbose查当前环境支持的 wheel 标签（比如musllinux_1_2），再确认你要装的包是否提供对应版本 - 常见不兼容包：tensorflow、torch、orjson、mysqlclient —— 这些强行装上会报
ImportError: Error loading shared library或段错误 - 能用
apk add装的优先用它，比如py3-numpy、py3-requests，它们已针对 musl 编译，体积小且无残留
多阶段构建 + 精确 COPY，只留运行必需
把构建和运行彻底分开，终态镜像里不带任何编译工具、缓存或源码。
- 构建阶段用
python:3.11-slim或完整镜像装依赖，终态阶段才切到alpine - 不要
COPY . /app，改用显式粒度：COPY app.py /app/app.py、COPY src/ /app/src/ - 依赖安装用
pip install --no-deps --target /tmp/deps -r requirements.txt，再COPY --from=builder /tmp/deps /usr/lib/python3.11/site-packages/ - 终态镜像中执行
python -m compileall -q -b /app，然后RUN find /app -name "__pycache__" -delete
强制清理，堵住所有体积泄漏点
很多“大镜像”其实就败在几个没删干净的角落。
- 每次
RUN安装编译工具后，必须加&& apk del .build-deps（比如 gcc、musl-dev） - pip 始终加
--no-cache-dir，否则/root/.cache/pip会固化进层 - 用
apk add --no-cache，避免/var/cache/apk残留 - 检查终态镜像有没有
.pyc、tests/、docs/、解压没删的.tar.gz—— 这些常被COPY venv/一起拖进去
实在不兼容时，退一步用 debian:slim
不是所有项目都适合 Alpine。如果核心依赖不支持 musl，硬上反而增加维护成本。
- 改用
python:3.11-slim（约 60MB），再配合apt-get clean && rm -rf /var/lib/apt/lists/* - 体积通常仍比 full Debian 小 40%，且兼容性零风险
- 比起盲目追求最小体积，稳定运行和可维护性更重要
