PyCharm中运行Dockerfile失败，请求故障排查指导

所用Dockerfile代码 #

FROM python:3.10-slim as builder

WORKDIR /app

ENV PYTHONDONTWRITEBYTECODE 1
ENV PYTHONUNBUFFERED 1

RUN apt-get update && apt-get install -y --no-install-recommends gcc

COPY . .
RUN pip wheel --no-cache-dir --no-deps --wheel-dir /wheels -r requirements.txt


# final stage
FROM python:3.10-slim

WORKDIR /app

COPY --from=builder /wheels /wheels
COPY --from=builder /app .

RUN pip install --no-cache /wheels/*
CMD ["python", "main.py"]

报错情况 #

构建执行到RUN pip install --no-cache /wheels/*步骤时失败，提示无法找到匹配的wheel文件。

排查方案 #

• 验证builder阶段wheel文件生成：在builder阶段的pip wheel命令后追加&& ls -l /wheels，查看是否有.whl文件生成。若没有，检查requirements.txt内的包是否存在下载/编译问题，部分包需额外系统依赖（如psycopg2需libpq-dev、numpy需gfortran），需在builder阶段安装对应依赖。
• 检查文件复制有效性：在final阶段的pip install命令前添加ls -l /wheels，确认builder阶段的wheel文件是否成功复制到当前镜像。
• 修正pip安装命令：将pip install --no-cache /wheels/*改为pip install --no-cache-dir --find-links=/wheels -r requirements.txt，避免通配符匹配问题，同时明确从本地wheel目录安装依赖。
• 检查.dockerignore配置：确认未误排除requirements.txt或其他必要文件，导致builder阶段无法读取需求清单。
• 清理缓存重新构建：执行docker build --no-cache，避免旧缓存干扰构建流程。

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