Distroless镜像部署Python3 Flask应用出现文件不存在错误求助

核心错误原因 #

1. ENTRYPOINT与CMD的冲突：distroless Python镜像默认将ENTRYPOINT设置为Python可执行文件（如/usr/bin/python3，对应实际的python3.7）。你当前的CMD写了["python3", "-m", ...]，会被拼接到ENTRYPOINT后执行，最终变成python3 python3 -m flask run ...——此时Python会把第二个python3当作要运行的脚本文件，自然找不到，抛出can't open file 'python3'的错误。
2. Python版本不匹配：构建阶段使用python:3.8-slim-buster（Python 3.8），但运行阶段的gcr.io/distroless/python3-debian10基于Debian 10，内置Python 3.7。跨版本复制site-packages可能导致依赖包兼容性问题。

修复步骤 #

1. 调整CMD写法（解决执行命令错误） #

由于distroless镜像已默认ENTRYPOINT为Python命令，只需在CMD中传入运行参数即可：

# 替换原CMD
CMD ["-m", "flask", "run", "--host=0.0.0.0"]

或者，如果你希望显式控制命令，也可以覆盖ENTRYPOINT：

ENTRYPOINT []
CMD ["python3", "-m", "flask", "run", "--host=0.0.0.0"]

2. 统一Python版本（避免依赖兼容性问题） #

将构建阶段的基础镜像改为与distroless匹配的Python 3.7版本：

# 原build-env基础镜像修改为3.7-slim-buster
FROM python:3.7-slim-buster as build-env

ADD / /app
WORKDIR /app

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

FROM gcr.io/distroless/python3-debian10

COPY --from=build-env /app /app
COPY --from=build-env /usr/local/lib/python3.7/site-packages /usr/local/lib/python3.7/site-packages
WORKDIR /app

ENV PYTHONPATH=/usr/local/lib/python3.7/site-packages

CMD ["-m", "flask", "run", "--host=0.0.0.0"]

3. 验证修复 #

重新构建镜像并运行：

docker build -t python-dockerdistro .
sudo docker run -p 5000:5000 python-dockerdistro

访问http://localhost:5000即可看到Flask应用页面。

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