构建Docker镜像时pip安装依赖报错，寻求解决思路

1. 补充slim镜像缺失的系统依赖 #

python:3.10-slim属于轻量镜像，缺少编译部分Python包所需的系统工具和依赖库，比如：

• psycopg2需要libpq-dev及编译工具（gcc、python3-dev）
• grpcio、greenlet等包依赖编译环境

修改Dockerfile，在pip安装前添加系统依赖安装步骤：

FROM python:3.10-slim

ENV PYTHONUNBUFFERED True
ENV APP_HOME /app
WORKDIR $APP_HOME
COPY . ./

# 安装系统依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    gcc \
    python3-dev \
    libpq-dev \
    && rm -rf /var/lib/apt/lists/*

RUN pip install --no-cache-dir -r requirements.txt

CMD ["python", "-u", "main.py"]

2. 检查可疑包NotFound==1.0.2 #

PyPI上无此标准包（或已下架/不存在），这大概率是安装失败的直接诱因：

• 若为自定义包，需确保构建环境中pip能访问到它（比如放在本地目录并修改requirements路径）
• 若为拼写错误，替换为正确包名
• 若该包非必需，直接从requirements.txt中删除

3. 排查版本兼容性问题 #

部分包间可能存在版本冲突：

• google==3.0.0是较旧包，可能与google-api-core==2.10.2、google-cloud-pubsub==2.13.11等新版本Google生态包不兼容
• protobuf==4.21.12与部分Google包的依赖版本可能存在冲突

尝试：

• 移除google==3.0.0（若项目未实际用到，或用google-api-python-client替代）
• 放宽部分包的版本限制（比如把==改成>=），让pip自动解决依赖兼容

4. 验证网络与PyPI源 #

若构建环境网络受限，pip无法正常访问PyPI，可切换国内镜像源加速安装：
修改pip安装命令：

RUN pip install --no-cache-dir -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt

5. 获取详细错误日志 #

重新执行构建时，添加--progress=plain参数查看完整pip安装错误信息，定位具体失败的包：

docker build --progress=plain -t your-image-name .

根据日志中的具体报错（如某包编译失败、找不到包等）针对性解决

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