Python 3.12无法安装包：OSError证书主机名不匹配问题求助

排查本地DNS与网络拦截 #

• 清空本地DNS缓存：
  • Windows：打开命令提示符，执行 ipconfig /flushdns
  • macOS/Linux：执行 sudo dscacheutil -flushcache（macOS）或 sudo systemd-resolve --flush-caches（Linux）
• 检查hosts文件是否被篡改：
  • Windows：打开C:\Windows\System32\drivers\etc\hosts，查看是否有指向files.pythonhosted.org的异常条目，如有则删除并保存
  • macOS/Linux：打开/etc/hosts，操作同上
• 临时关闭本地安全软件（杀毒、防火墙、VPN/代理工具）：这类软件可能拦截或篡改SSL证书，关闭后重试pip下载和浏览器访问

修复系统证书信任问题 #

• 更新系统根证书：
  • Windows：进入「设置」→「更新和安全」→「Windows更新」，安装所有包含证书更新的可选补丁
  • macOS：进入「系统设置」→「通用」→「关于本机」→「软件更新」，安装可用系统更新
  • Linux：根据发行版执行命令，如Ubuntu/Debian用 sudo apt update && sudo apt install --reinstall ca-certificates，CentOS/RHEL用 sudo yum update ca-certificates
• 临时绕过证书验证（仅应急用）：执行 pip install --trusted-host files.pythonhosted.org [你的包名]，不建议长期使用此方法

重置Python环境配置 #

• 检查pip配置：执行 pip config list，查看是否有异常的index-url或trusted-host配置，如有则用 pip config unset [配置项名称] 删除
• 重置Python SSL相关组件（Linux/macOS）：若系统SSL库损坏，可重新安装openssl后，重新编译Python（仅其他方法无效时尝试）

验证网络解析 #

• 执行 ping files.pythonhosted.org 和 nslookup files.pythonhosted.org，对比正常设备的解析结果，确认IP归属是否正常
• 手动更换DNS服务器：将系统DNS改为8.8.8.8或1.1.1.1，再尝试访问

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