Docker中使用requirements.txt安装Python依赖失败求助

咱们先把问题拆明白：你遇到的核心是numpy版本的依赖冲突，而pip freeze生成requirements.txt的方式放大了这个问题。

从错误日志能看到关键矛盾：

• TensorFlow 2.5.0硬性要求numpy~=1.19.2（也就是只能用1.19.x系列）
• 但cmdstanpy 1.0.8要求numpy>=1.21，pmdarima 2.0.2要求numpy>=1.21.2
  这两个要求完全不兼容，pip的新版本依赖解析器会严格检查这种冲突，所以直接报错。

另外，你用pip freeze > requirements.txt生成依赖的方式有个坑：它会把本地环境里所有包（包括间接依赖）的精确版本都列出来。你的本地环境可能是通过某种方式（比如旧版pip自动忽略冲突、或者你手动强制安装）“勉强”运行的，但Docker是全新的干净环境，严格的依赖检查就把隐藏的冲突暴露出来了。

针对这个问题，咱们分步骤来解决：

1. 修复核心的numpy版本冲突 #

这是最关键的一步，有两种可行方向：

• 方向一：升级TensorFlow到兼容高版本numpy的版本
  TensorFlow 2.6及以上版本已经支持numpy 1.21+，你可以把requirements.txt里的tensorflow==2.5.0改成tensorflow>=2.6.0，同时把tensorboard==2.5.0也对应升级（比如tensorboard>=2.6.0）。这样就能满足cmdstanpy和pmdarima对numpy的要求，冲突自然就解决了。
• 方向二：降级cmdstanpy和pmdarima到兼容numpy 1.19.2的版本
  如果你必须保留TensorFlow 2.5.0，那得找cmdstanpy和pmdarima的旧版本：
  • cmdstanpy 0.9.75及之前的版本支持numpy 1.19.x
  • pmdarima 1.8.5及之前的版本支持numpy 1.19.x
    把这两个包的版本改成对应的旧版本，就能和TensorFlow的numpy要求匹配。不过这个方向可能会损失一些新功能，优先推荐方向一。

2. 优化requirements.txt的维护方式 #

别再用pip freeze直接生成依赖了，它会把所有间接依赖都锁死，很容易导致跨环境的冲突。建议：

• 手动维护requirements.txt，只列你直接使用的包，不要包含间接依赖（比如numpy这种是其他包的依赖，除非你自己直接调用它）。
• 对必须指定版本的包，用版本范围而不是精确版本，比如tensorflow>=2.6.0,<3.0，给pip留足解析空间。
• 如果需要锁定版本（比如生产环境），可以用pip-compile（来自pip-tools工具）生成精确的requirements.txt，它会自动解决依赖冲突后再锁定版本，比pip freeze靠谱得多。

3. 解决pip超时问题 #

移除版本号后pip要尝试大量版本组合，加上网络问题就容易超时，你可以这么处理：

• 在Dockerfile的pip命令里加超时参数：pip install --default-timeout=300 -r requirements.txt，把超时时间拉长到5分钟。
• 改用国内PyPI镜像源加快下载：pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt，大幅减少下载时间。
• 提前安装核心依赖（比如numpy）：在安装requirements.txt之前先单独装指定版本的numpy，这样pip不用再花时间解析它的版本，比如：

  RUN pip install --upgrade pip && \
      pip install numpy~=1.19.2 && \  # 或者对应你最终确定的版本
      pip install --no-cache-dir -r requirements.txt
  

4. 优化Docker构建效率 #

你的Dockerfile可以调整一下，利用Docker的缓存机制，减少重复构建时间：

FROM python:3.9
WORKDIR /usr/app/
# 先复制requirements.txt，安装依赖，利用缓存
COPY requirements.txt ./
RUN pip install --upgrade pip && \
    pip install --default-timeout=300 --no-cache-dir -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt
# 最后复制代码，修改代码不会触发依赖重新安装
COPY . ./
ENTRYPOINT ["python"]
CMD ["app.py"]

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