Dockerfile执行COPY命令报错：无法复制到非目录路径

问题根源 #

1. Build阶段未安装依赖：你的build阶段仅复制了requirements.txt，但没有执行依赖安装命令，导致后续要复制的site-packages目录无实际内容。
2. 跨镜像目录结构冲突：python:3.9-slim和distroless/python3-debian11的文件系统结构存在差异，比如/usr/share/zoneinfo/posix/Africa在前者中是文件，在后者中可能是目录（或不存在），直接复制整个/usr目录会触发类型不匹配的报错。

修复步骤 #

1. 完善Build阶段，正确安装依赖 #

修改build阶段的Dockerfile，添加依赖安装命令，确保依赖被安装到指定目录：

FROM python:3.9-slim as build

# 安装依赖到/app/deps目录（避免干扰系统site-packages）
COPY requirements.txt /requirements.txt
RUN pip install --no-cache-dir -r /requirements.txt -t /app/deps

2. 调整COPY命令，仅复制必要内容 #

在最终镜像中，只复制应用代码和安装好的依赖，避免复制整个/usr目录：

FROM gcr.io/distroless/python3-debian11

COPY . /app
WORKDIR /app

# 从build阶段复制依赖到应用目录的deps子文件夹
COPY --from=build /app/deps /app/deps

# 设置Python路径，让解释器能找到依赖
ENV PYTHONPATH=/app/deps:$PYTHONPATH
ENV PYTHONUNBUFFERED=1

EXPOSE 5000

CMD ["src/standalone.py"]

3. 替代方案：复制系统site-packages（如果必须） #

如果你坚持要从build阶段复制系统的site-packages，需要确保目标路径存在且是目录，同时避免复制冲突文件：

FROM python:3.9-slim as build

WORKDIR /app
COPY requirements.txt /requirements.txt
RUN pip install --no-cache-dir -r /requirements.txt

FROM gcr.io/distroless/python3-debian11

COPY . /app
WORKDIR /app

# 先确保目标目录存在
RUN mkdir -p /usr/lib/python3.9/site-packages
# 仅复制site-packages下的内容，而非整个/usr
COPY --from=build /usr/local/lib/python3.9/site-packages/* /usr/lib/python3.9/site-packages/

ENV PYTHONUNBUFFERED=1

EXPOSE 5000

CMD ["src/standalone.py"]

关键注意事项 #

• 避免跨镜像复制整个系统目录（如/usr），不同基础镜像的文件结构差异会导致各种冲突。
• Distroless镜像本身非常精简，仅包含运行Python程序的必要组件，不要试图将完整的系统文件复制进去。

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