Dockerfile构建报错：failed to compute cache key: "/Pipfile.lock" not found

一、解决"无法计算缓存键，找不到/Pipfile.lock"错误 #

1. 生成Pipfile.lock文件 #

在执行docker build的项目根目录下，运行命令生成锁文件：

pipenv lock

这会根据当前Pipfile的依赖配置生成对应的Pipfile.lock，确保两个文件都在构建上下文目录中。

2. 确认文件位置正确 #

Docker构建时，COPY命令只能访问构建上下文目录（即执行docker build的目录）下的文件。检查Pipfile和Pipfile.lock是否都在该目录，不要放在子目录或其他路径下。

3. 临时应急方案（不推荐长期使用） #

如果暂时无法生成Pipfile.lock，可以修改Dockerfile：

• 将COPY行改为仅复制Pipfile：

  COPY Pipfile /sphinxtechnicalwriting/
  

• 去掉安装命令的--deploy参数（该参数强制要求存在lock文件）：

  RUN pipenv install --system
  

注意：此方法会失去依赖版本锁定能力，可能导致不同环境依赖不一致，仅作临时解决手段。

二、解决第一条RUN命令CANCELED状态问题 #

该问题多由网络连接异常导致（第一条RUN包含apt-get update、pip install等联网操作），可按以下步骤处理：

1. 检查网络连通性 #

确认运行Docker构建的机器能正常访问外网，执行以下命令测试：

ping deb.debian.org
ping pypi.org

若无法连通，先排查防火墙、代理等网络配置问题。

2. 更换国内镜像源 #

如果是网络慢或访问受限，修改Dockerfile中的源地址：

• 替换apt源为国内镜像（如清华源），同时更换pip源：

  FROM python:3.8-slim-buster
  RUN sed -i 's/deb.debian.org/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list && \
      apt-get update && \
      apt-get -y upgrade && \
      apt-get install -y --no-install-recommends make && \
      apt-get clean && \
      rm -rf /var/lib/apt/lists/* && \
      pip install --no-cache-dir --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple && \
      pip install --no-cache-dir pipenv -i https://pypi.tuna.tsinghua.edu.cn/simple
  
  WORKDIR /sphinxtechnicalwriting
  
  COPY Pipfile Pipfile.lock /sphinxtechnicalwriting/
  
  RUN pipenv install --system --deploy
  

3. 重新执行构建 #

若只是临时网络波动，直接重新运行构建命令：

docker build .

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