2026-01-02 935 字 5 分钟 -- 次

pip安装python库报ssl错误

最后更新于: 2026-06-27 14:35:29

范例：pip安装python库报ssl错误-2023.6.17(已解决)

1、报错现象

 1C:\Users\Win>pip install ipython
 2Looking in indexes: https://pypi.tuna.tsinghua.edu.cn/simple
 3WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLEOFError(8, 'EOF occurred in violation of protocol (_ssl.c:1124)'))': /simple/ipython/
 4WARNING: Retrying (Retry(total=3, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLEOFError(8, 'EOF occurred in violation of protocol (_ssl.c:1124)'))': /simple/ipython/
 5WARNING: Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLEOFError(8, 'EOF occurred in violation of protocol (_ssl.c:1124)'))': /simple/ipython/
 6WARNING: Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLEOFError(8, 'EOF occurred in violation of protocol (_ssl.c:1124)'))': /simple/ipython/
 7WARNING: Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLEOFError(8, 'EOF occurred in violation of protocol (_ssl.c:1124)'))': /simple/ipython/
 8Could not fetch URL https://pypi.tuna.tsinghua.edu.cn/simple/ipython/: There was a problem confirming the ssl certificate: HTTPSConnectionPool(host='pypi.tuna.tsinghua.edu.cn', port=443): Max retries exceeded with url: /simple/ipython/ (Caused by SSLError(SSLEOFError(8, 'EOF occurred in violation of protocol (_ssl.c:1124)'))) - skipping
 9ERROR: Could not find a version that satisfies the requirement ipython (from versions: none)
10ERROR: No matching distribution found for ipython

2、报错环境

win10

之前是有配置pip源为清华源：

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

3、测试过程

换其他源还是报错（失败）

百度：替换为豆瓣源并加`--trusted-host参数`(成功)

原因分析:

无法访问到https://pypi.tuna.tsinghua.edu.cn/simple/pip，SSL证书认证问题。

解决办法：

pip install ipython –trusted-host pypi.tuna.tsinghua.edu.cn 在语句后面将其设置为可信任即可，问题得到了解决。

使用清华源安装：（==会报错==）

1pip install -i https://pypi.tuna.tsinghua.edu.cn/simple ipython --trusted-host pypi.tuna.tsinghua.edu.cn

使用豆瓣源安装：(==成功==)

1pip install -i  http://pypi.douban.com/simple/ ipython --trusted-host pypi.douban.com

可以看到，此时2023年6月17日清华源不能用了，这里就暂且使用豆瓣源即可。

永久配置使用豆瓣源：

1pip config set global.index-url http://pypi.douban.com/simple/
2
3#后面使用如下命令安装python库就好
4pip install ipython --trusted-host pypi.douban.com

推荐配置

1pip config set global.index-url http://pypi.douban.com/simple/
2pip config set install.trusted-host pypi.douban.com
3
4#后面使用如下命令安装python库就好
5#pip install ipython --trusted-host pypi.douban.com
6pip install ipython