使用pip安装任意包时报错ValueError: check_hostname requires server_hostname

报错根因 #

该报错本质是pip运行时仍读取到了不规范的残留代理配置，发起HTTPS请求时SSL校验缺少必要的服务端主机名参数触发异常，和setuptools版本无关。

修复步骤 #

• 第一步：清空当前终端的代理环境变量
  打开cmd窗口依次执行以下命令：

set http_proxy=
set https_proxy=
set HTTP_PROXY=
set HTTPS_PROXY=

执行完成后直接在当前窗口测试pip install PyAudio是否能正常运行，如恢复正常说明是系统环境变量残留了代理配置，可进入系统高级设置-环境变量，删除用户变量和系统变量中所有带proxy的相关条目即可永久解决。

• 第二步：清理pip配置文件中的残留代理
  如果第一步执行后问题依旧，找到pip配置文件：
  Windows系统下配置文件路径为C:\Users\你的用户名\pip\pip.ini或者%APPDATA%\pip\pip.ini，打开文件后删除[global]段落中所有proxy = xxx的配置行，保存后重试即可。
• 第三步：临时强制禁用代理测试
  如果还是有问题，可执行以下命令强制指定空代理安装测试：

pip install PyAudio -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn --proxy=""

注意事项 #

后续如果需要重新给pip配置代理，要保证代理地址格式完整，必须携带协议头，示例：http://127.0.0.1:7890，缺失协议头或者地址信息会再次触发该报错。

内容的提问来源于stack exchange，提问作者Priyanka