博客

python使用pip安装模块出现ReadTimeoutError: HTTPSConnectionPool的解决方法

  • Post category:Python

Python使用pip安装模块出现ReadTimeoutError: HTTPSConnectionPool的解决方法

问题描述

在使用Python的pip安装模块时，可能会出现以下错误信息：

ReadTimeoutError: HTTPSConnectionPool(host='xxx', port=443): Read timed out. (read timeout=XX)

这种错误通常与网络连接有关，pip在从远程仓库下载模块时，如果网络连接超时，就会出现这种错误。

解决方法

1. 升级pip版本

pip版本过低，可能会导致这种错误发生。我们可以通过升级pip来解决这个问题。

# Windows
python -m pip install --upgrade pip

# Linux/MacOS
pip install --upgrade pip

2. 更换pip源

国内访问国外的pip源速度较慢，很容易出现连接超时的情况。我们可以将pip源更换为国内的源，以提高下载速度和稳定性。

2.1 使用阿里云镜像源

阿里云提供了Python镜像源，可以加快Python模块的下载速度。我们可以使用以下命令来更换pip源：

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

2.2 使用清华大学镜像源

清华大学的镜像源也是国内比较常用和稳定的Python镜像源，使用方法如下：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/

示例说明

示例一

在Windows 10系统下使用Python 3.7版本的pip安装numpy模块时，出现了ReadTimeoutError: HTTPSConnectionPool的问题。解决步骤如下：

  1. 升级pip版本，如上述第一种解决方法；
  2. 更换pip源，使用清华大学的镜像源，如上述第二种解决方法。
python -m pip install --upgrade pip
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/
pip install numpy

示例二

在Mac OS系统下使用Python 3.8版本的pip安装requests模块时，也出现了ReadTimeoutError: HTTPSConnectionPool的问题。解决步骤如下：

  1. 升级pip版本，如上述第一种解决方法；
  2. 更换pip源，使用阿里云镜像源，如上述第二种解决方法。
pip install --upgrade pip
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
pip install requests

通过以上步骤的处理，可以解决Python使用pip安装模块出现ReadTimeoutError: HTTPSConnectionPool的问题。

Tags: