Docker多阶段构建无法从前置阶段复制文件问题求助

问题根源 #

你遇到的错误并非文件真的不存在，而是依赖缺失：

• scratch是完全空的基础镜像，不含任何系统级依赖库（比如glibc、动态链接器等）。
• PyInstaller用--onefile打包的二进制文件，本质依赖宿主构建环境（python:3.10镜像基于Debian，包含glibc等库）的动态链接库才能运行，在scratch中找不到这些依赖，就会抛出这个误导性错误。
• 而python slim镜像本身基于Debian，自带这些基础系统库，因此能满足二进制的运行需求。

可行解决方法 #

方法1：用Alpine镜像替代scratch（兼顾体积与兼容性） #

Alpine是轻量Linux发行版，自带musl libc，体积远小于debian slim，同时能提供基础运行依赖。修改Dockerfile如下：

FROM python:3.10-alpine AS builder

# 安装编译依赖（适配Alpine的musl环境）
RUN apk add --no-cache gcc musl-dev libffi-dev
RUN pip install --upgrade pip
RUN pip install pyinstaller

WORKDIR /app

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

COPY . .

RUN pyinstaller --onefile --clean --name app --noconfirm app.py

FROM alpine:latest

COPY --from=builder /app/dist/app /app/app

CMD ["/app/app"]

注意：如果你的Python依赖包含仅支持glibc的二进制包，可能需要额外调整适配Alpine环境。

方法2：用Debian Slim作为最终镜像（兼容性最优） #

直接沿用你验证过的debian系环境，镜像体积比Alpine大，但兼容性最好，无需额外适配：

FROM python:3.10 AS builder

RUN pip install --upgrade pip
RUN pip install pyinstaller

WORKDIR /app

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

COPY . .

RUN pyinstaller --onefile --clean --name app --noconfirm app.py

FROM debian:bookworm-slim

COPY --from=builder /app/dist/app /app/app

CMD ["/app/app"]

方法3：静态编译二进制（仅适合深度定制场景） #

如果一定要使用scratch，需要让PyInstaller生成完全静态的二进制文件。这需要在构建阶段使用静态编译的Python环境，或添加--static参数（需额外安装musl-gcc等工具），但该方式复杂度高，容易出现依赖兼容问题，不推荐新手尝试。

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