无法安装任何Python包（疑因urllib3变动）：ValueError报错求助
2026-8-25
解决pip安装包时出现"ValueError: check_hostname requires server_hostname"的问题
这个错误大概率是网络代理配置异常或pip/依赖包版本兼容性问题导致的，以下是针对性的解决步骤：
检查并清除代理设置
该报错常见于代理配置错误，先排查代理相关设置：- 查看当前pip代理配置：
pip config get global.proxy - 若存在代理记录，执行清除命令：
pip config unset global.proxy - 同时检查系统环境变量中的
HTTP_PROXY、HTTPS_PROXY，临时取消：- Windows终端：
set HTTP_PROXY=和set HTTPS_PROXY= - Linux/macOS终端：
unset HTTP_PROXY HTTPS_PROXY
- Windows终端：
- 查看当前pip代理配置：
升级pip至最新版本
你的pip版本（21.2.4）可能存在兼容性缺陷，尝试升级：- 基础升级命令：
python -m pip install --upgrade pip - 若升级时仍报错，添加信任参数绕过证书问题：
python -m pip install --upgrade pip --trusted-host pypi.org --trusted-host files.pythonhosted.org
- 基础升级命令：
修复urllib3与requests的版本兼容性
单独更新urllib3可能导致和requests版本不匹配，先查看当前版本：pip show urllib3 requests- 安装兼容Python3.9的稳定版本组合：
pip install urllib3==1.26.15 requests==2.31.0
重置pip配置文件
若pip配置文件损坏，删除对应文件重置：- Windows：删除路径
%APPDATA%\pip\pip.ini - Linux/macOS：删除路径
~/.config/pip/pip.conf或~/.pip/pip.conf
- Windows：删除路径
使用国内镜像源安装包
绕过网络代理问题，直接用国内镜像安装xgboost：pip install xgboost -i https://pypi.tuna.tsinghua.edu.cn/simple- 若仍有证书报错，添加信任参数：
pip install xgboost -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn
内容的提问来源于stack exchange，提问作者V.Medvedev
相关产品推荐
相关产品推荐
