Docker构建镜像时pip3安装requirements.txt依赖失败如何解决

问题原因 #

• 最核心的问题是requirements.txt生成逻辑错误：你直接在本地Debian/Ubuntu系统的全局Python环境，或者绑定了系统依赖的虚拟环境中执行pip freeze，会把大量系统专属的Python工具包（比如报错的apt-clone是Ubuntu/Debian自带的系统工具，不会上传到PyPI源）也导出到依赖列表中，Docker构建时去PyPI查找对应包自然会失败。
• 如果你确认删除多余包后所有依赖都无法安装，通常是两个原因：一是默认PyPI源网络访问不稳定，二是slim版基础镜像缺少必要的编译依赖，部分需要本地编译的Python包无法完成安装。

解决方案 #

第一步：修复依赖列表生成逻辑 #

1. 本地为你的Python应用单独创建纯净的虚拟环境，不要使用系统全局Python环境
2. 激活虚拟环境后，仅安装你项目实际用到的依赖（比如flask等业务依赖）
3. 执行pip freeze > requirements.txt，此时生成的依赖列表不会包含系统专属的多余包。

第二步：适配Docker构建配置 #

如果修复依赖列表后仍出现安装失败问题，修改你的Dockerfile适配本地环境：

1. 给pip配置国内源，加快访问速度避免网络故障，修改安装命令为：

   RUN pip3 install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt
   

2. 如果存在需要编译的二进制依赖包，在安装Python依赖前先安装系统级编译依赖，修改后的完整Dockerfile参考：

   # syntax=docker/dockerfile:1
   FROM python:3.8-slim-buster
   WORKDIR /app
   # 安装系统依赖，安装后清理缓存减小镜像体积
   RUN apt update && apt install -y --no-install-recommends gcc python3-dev \
       && rm -rf /var/lib/apt/lists/*
   COPY requirements.txt requirements.txt
   RUN pip3 install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt
   COPY . .
   CMD [ "python3", "-m", "flask","run","--host=0.0.0.0" ]
   

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