Docker多阶段构建镜像运行时提示找不到Python venv可执行文件

报错里提示找不到/app/venv/bin/python3是Linux下非常有迷惑性的经典错误：不是这个文件真的不存在，而是内核加载这个二进制文件时，找不到它依赖的动态链接器或者共享库，直接返回了"no such file or directory"的错误码。你用docker export能在tar包里找到对应文件，恰恰说明文件本身拷贝成功了，只是运行依赖不全。
具体到你的两阶段构建逻辑，有两个致命问题：

• 第一阶段执行python3 -m venv创建虚拟环境时，默认生成的/app/venv/bin/python3是指向构建镜像内系统Python（路径/usr/local/bin/python3）的软链接，而且这个Python二进制是动态编译的，运行需要依赖glibc、libpython3.9.so等一堆系统级共享库，这些文件都存在于build阶段镜像的/lib、/usr/lib目录下，你第二阶段只拷贝了/app目录，这些依赖完全没带过去。
• 你第二阶段用的gcr.io/distroless/python3镜像自带的Python运行时，和第一阶段用的Python3.9.5的动态依赖路径、版本不匹配，根本加载不了你从build阶段复制过来的虚拟环境Python二进制。

优先选方案1，稳定性最高，镜像体积也更小。

方案1：复用distroless自带的Python运行时，不跨镜像拷贝虚拟环境 #

distroless/python3镜像本身已经内置了对应版本的Python解释器和完整的运行依赖，不需要你从构建阶段拷贝Python二进制，只需要把pip安装的第三方依赖和项目代码复制过去即可。
注意构建阶段使用的Python大版本必须和distroless/python3内置的Python版本完全一致（目前distroless/python3默认对应Python3.9），否则依赖包会因为版本不兼容报错。
修改后的Dockerfile如下：

# syntax=docker/dockerfile:1
FROM python:3.9-slim-buster as build
# 创建临时目录存放安装的Python依赖
RUN mkdir /install
WORKDIR /install
COPY requirements.txt .
# 将所有依赖安装到指定前缀目录，不污染构建环境系统路径
RUN pip install --no-cache-dir --prefix=/install -r requirements.txt

FROM gcr.io/distroless/python3
# 把构建阶段装好的第三方依赖拷贝到distroless镜像的Python包搜索路径
COPY --from=build /install/lib/python3.9/site-packages /usr/lib/python3.9/
# 拷贝项目代码
COPY . /app
WORKDIR /app
EXPOSE 5000
# 直接调用distroless内置的python执行入口
ENTRYPOINT ["python3", "main.py"]

提示：如果你使用指定版本tag的distroless/python3镜像（比如gcr.io/distroless/python3:3.10），只需要把构建阶段的基础镜像换成对应大版本的Python slim镜像，同时把依赖拷贝路径中的python3.9替换为对应版本号即可。

方案2：完整拷贝虚拟环境+所有运行依赖（不推荐） #

如果你一定要复用第一阶段创建的venv，必须解决软链接和动态依赖缺失的问题：创建venv时强制复制二进制而非生成软链接，同时把Python运行需要的所有动态库、动态链接器一起拷贝到运行阶段镜像。
这种方案维护成本很高，一旦Python版本、系统架构有差异就会运行失败，仅做参考：

# syntax=docker/dockerfile:1

FROM python:3.9.5-slim-buster as build
# 创建venv时加--copies参数，复制二进制文件而非生成软链接
RUN python3 -m venv --copies /app/venv
COPY . /app
RUN /app/venv/bin/pip install --no-cache-dir -r /app/requirements.txt
# 提取venv中python二进制依赖的所有动态库，复制到可打包路径
RUN ldd /app/venv/bin/python3 | tr -s '[:space:]' '\n' | grep '^/' | xargs -I {} cp {} /app/venv/lib/
# 拷贝64位Linux系统需要的动态链接器
RUN cp /lib64/ld-linux-x86-64.so.2 /app/venv/lib/

FROM gcr.io/distroless/python3
COPY --from=build /app /app
# 配置动态库搜索路径
ENV LD_LIBRARY_PATH=/app/venv/lib
EXPOSE 5000
# 用绝对路径指定入口文件，避免工作目录问题
ENTRYPOINT [ "/app/venv/bin/python3" , "/app/main.py"]

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