requests离线包安装依赖缺失怎么办？

Question

在使用 `requests` 离线安装包进行部署时，常遇到依赖缺失问题，如 `urllib3`、`chardet`、`idna` 等模块未被包含，导致安装后无法正常运行。这是因为离线包仅包含主库文件，未打包其依赖项。此时应如何处理？一种解决方案是提前使用 `pip download` 命令完整下载 `requests` 及其依赖，再打包至目标环境中一并安装。也可手动下载缺失的依赖包并依次安装。此外，使用 `pipdeptree` 检查依赖关系，或采用 `pip install --no-deps` 配合自定义依赖清单也是一种可行方式。掌握离线依赖管理方法，是保障内网部署顺利的关键。

Answer 1

一、背景与问题现象

在内网环境中使用 requests 的离线安装包进行部署时，经常遇到运行时报错，提示 ModuleNotFoundError，常见缺失模块包括 urllib3、chardet 和 idna。这些模块是 requests 的依赖项，但由于离线安装包仅包含主库文件，未打包其依赖库，导致程序无法正常执行。

二、问题分析

• requests 依赖结构复杂：requests 本身依赖多个第三方库，如 urllib3（负责底层网络请求）、chardet（字符编码检测）、idna（国际化域名支持）等。
• 离线包未包含依赖：通常使用 pip install --no-index 安装离线包时，若未提前准备好依赖包，会因缺失依赖而失败。
• 依赖版本不兼容风险：不同版本的 requests 对依赖版本要求不同，手动安装时容易引入版本冲突。

三、解决方案与实践

1. 使用 pip download 完整下载依赖

在有网络的环境中，使用以下命令可完整下载 requests 及其所有依赖：

pip download requests

该命令会将 requests 及其所有依赖包（如 urllib3、chardet、idna）下载到当前目录，打包后可整体复制到目标机器进行离线安装。

2. 手动下载并安装缺失的依赖

若已知缺失的依赖名称，可手动下载对应版本的包并依次安装：

pip install --no-index --find-links=/path/to/packages/ urllib3-1.26.12-py2.py3-none-any.whl

这种方式适合依赖数量较少、版本明确的场景。

3. 使用 pipdeptree 检查依赖关系

安装 pipdeptree 后，可查看 requests 的完整依赖树：

pip install pipdeptree

pipdeptree -p requests

输出示例如下：

requests==2.31.0
  - chardet [required: >=3.0.2,<6, installed: 3.0.4]
  - idna [required: >=2.5,<4, installed: 2.8]
  - urllib3 [required: >=1.21.1,<3, installed: 1.26.12]

4. 使用 pip install --no-deps 配合自定义依赖清单

若希望更精细控制安装过程，可先使用 --no-deps 安装主包，再按依赖清单逐个安装：

pip install --no-deps requests-2.31.0-py3-none-any.whl

pip install chardet-3.0.4-py2.py3-none-any.whl

pip install idna-2.8-py2.py3-none-any.whl

pip install urllib3-1.26.12-py2.py3-none-any.whl

四、流程图示意

graph TD
            A[准备 requests 安装包] --> B{是否包含完整依赖?}
            B -->|是| C[直接安装]
            B -->|否| D[下载完整依赖]
            D --> E[使用 pip download]
            D --> F[手动下载依赖]
            D --> G[使用 pipdeptree 分析]
            E --> H[打包并传输到目标环境]
            F --> H
            G --> H
            H --> I[使用 pip install 安装]

五、经验总结与建议

在进行离线部署时，推荐使用以下流程：

1. 在联网环境中使用 pip download requests 下载完整依赖包
2. 将所有包打包为 tar.gz 或 zip 文件
3. 在目标环境中解压后，使用 pip install --no-index --find-links=. 进行安装
4. 使用 pipdeptree 验证是否所有依赖均已安装

六、常见依赖包清单

依赖包名称	典型版本	用途
urllib3	1.26.x	底层 HTTP 连接池
chardet	3.0.4	自动检测文本编码
idna	2.8	IDN 域名解析
certifi	2023.x.x	SSL 证书验证