当前位置：首页 > news >正文

【已解决】报错：WARNING: pip is configured with locations that require TLS/SSL

news 2025/8/12 7:51:45

- 一、问题背景
- 二、问题分析
- - 1. SSL模块缺失的本质
  - 2. Anaconda环境特点
- 三、问题表现
- 四、解决方案详解
- - 1. 完整配置环境变量
  - 2. 添加环境变量的步骤
  - 3. 测试验证
- 五、实战示例
- 六、附加建议
- 七、总结
- 八、参考链接

一、问题背景

在Windows 10系统中使用Python的包管理工具pip时，常常遇到类似如下的报错：

WARNING: pip is configured with locations that require TLS/SSL, however the ssl module in Python is not available.
Could not fetch URL https://mirrors.aliyun.com/pypi/simple/pip/: There was a problem confirming the ssl certificate: HTTPSConnectionPool(host='mirrors.aliyun.com', port=443): Max retries exceeded with url: /pypi/simple/pip/ (Caused by SSLError("Can't connect to HTTPS URL because the SSL module is not available.")) - skipping

这类错误导致无法通过pip安装或更新Python包，尤其是在非Anaconda自带的命令行窗口（例如普通cmd）下执行pip时尤为明显。本文将从根源分析此问题的成因，并给出Windows系统下的针对性解决方案，确保pip的正常运行。

二、问题分析

1. SSL模块缺失的本质

Python的ssl模块依赖底层操作系统的OpenSSL库支持，负责支持Python通过HTTPS协议进行安全通信。该模块不可用，通常是因为Python解释器运行时无法正确加载SSL相关的动态链接库（DLL），导致pip无法建立HTTPS连接。

2. Anaconda环境特点

Anaconda集成了Python环境及大量科学计算库，并且默认配置了自己的环境路径。它包含一套完整的Library\bin目录，存放着OpenSSL所需的DLL文件（例如libcrypto-1_1-x64.dll和libssl-1_1-x64.dll）。如果环境变量配置不完整，普通cmd无法找到这些动态库，自然就会导致ssl模块不可用。

三、问题表现

通过Anaconda Prompt执行pip命令正常。
通过Windows系统普通CMD或PowerShell执行pip命令时报错，提示无法使用ssl模块。
只添加了D:\Anaconda3\Scripts环境变量，忽略了关键的D:\Anaconda3和D:\Anaconda3\Library\bin目录。

四、解决方案详解

1. 完整配置环境变量

确保系统环境变量中Path包含以下3个路径：

D:\Anaconda3
- 包含Python主解释器及标准库。
D:\Anaconda3\Scripts
- 存放pip等命令行工具。
D:\Anaconda3\Library\bin
- 关键，存放OpenSSL相关的动态库，支持ssl模块正常加载。

注意：很多用户只配置了Scripts，这导致在普通cmd下运行时无法找到SSL的DLL文件。

2. 添加环境变量的步骤

右键【此电脑】→【属性】→【高级系统设置】→【环境变量】。
在【系统变量】或【用户变量】中找到Path，点击【编辑】。
依次点击【新建】，添加以上三个路径（根据你的Anaconda安装目录修改）。
确认保存，关闭所有终端窗口，重新打开普通CMD测试。

3. 测试验证

在新打开的CMD窗口中，执行：

python -c "import ssl; print(ssl.OPENSSL_VERSION)"
pip --version

如果正常显示OpenSSL版本号且pip能正常执行，说明配置成功。

五、实战示例

假设Anaconda安装在D:\Anaconda3目录：

路径	作用
D:\Anaconda3	Python解释器及核心库
D:\Anaconda3\Scripts	pip和conda命令行工具
D:\Anaconda3\Library\bin	OpenSSL等动态库，支持ssl模块

添加后执行：

set PATH=D:\Anaconda3;D:\Anaconda3\Scripts;D:\Anaconda3\Library\bin;%PATH%
pip install --upgrade pip

若无报错即完成配置。

六、附加建议

不要手动替换Python自带的OpenSSL库文件，以免破坏环境。
使用Anaconda Prompt时系统会自动加载正确环境变量，适合快速使用。
若长期使用普通CMD，务必完成上述环境变量配置。
如果问题依旧，建议检查Anaconda版本和Python版本是否兼容。
遇到SSL相关错误时，也可考虑临时使用HTTP源（非安全），但不建议长期使用。

七、总结

Windows系统下pip报错“ssl module in Python is not available”大多因环境变量配置不完整导致。完整添加Anaconda安装目录及其Scripts和Library\bin路径至系统环境变量，即可解决该问题，恢复pip正常使用。本文希望能帮助大家快速定位并解决该类问题，避免影响开发效率。