如何解决Python中使用pip安装包时遇到的SSL证书验证失败问题？-Python教程-PHP中文网

优先升级certifi并设置ssl_cert_file环境变量可解决90%的certificate_verify_failed错误；若仍失败，可临时用--trusted-host跳过验证，但存在安全风险。

如何解决python中使用pip安装包时遇到的ssl证书验证失败问题？

pip install 报 CERTIFICATE_VERIFY_FAILED 怎么办

这不是网络连不上，也不是 PyPI 服务器出问题，而是你本地 Python 找不到或没用对根证书。90% 的情况，升级 certifi + 设置 SSL_CERT_FILE 环境变量就能解决，不用动代理、不用关验证。

先确认 ssl 模块是否可用

别急着配证书，先看底层有没有坏：

运行 python -c "import ssl; print(ssl.OPENSSL_VERSION)"，如果报 ModuleNotFoundError: No module named '_ssl'，说明 Python 编译时没链接 OpenSSL，或系统 OpenSSL 版本太旧（如 CentOS7 默认的 OpenSSL 1.0.2k 不支持 Python 3.12+）
运行 python -m ssl，若直接报错 ImportError，就得重装 Python 或手动编译并指定 --with-openssl=/usr/local/openssl
系统时间偏差超过 3 分钟也会导致证书“未生效”或“已过期”，先跑 date 确认时间准确

升级 certifi 并强制 Python 使用它

很多报错其实是因为 pip 还在读旧版 certifi 里的证书文件，而新版 Let’s Encrypt 根证书（如 ISRG Root X1/X2）根本不在里面。

Python 3.14.2

Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。

下载

执行 pip install --upgrade certifi --user（加 --user 更安全，避免权限冲突）
检查路径是否更新：python -c "import certifi; print(certifi.where())"，输出必须是类似 site-packages/certifi/cacert.pem 的真实路径；如果看到 /Applications/Python 3.x//cacert.pem 这类路径，说明还在用 macOS 安装包自带的旧证书——删掉那个目录下的 cacert.pem
设环境变量绑定：
macOS/Linux：export SSL_CERT_FILE=$(python -c "import certifi; print(certifi.where())")
Windows PowerShell：$env:SSL_CERT_FILE=(python -c "import certifi; print(certifi.where())")
加到 ~/.zshrc 或 ~/.bash_profile 才能永久生效
验证是否生效：python -c "import ssl; print(ssl.get_default_verify_paths())"，输出里要有你刚设的 SSL_CERT_FILE 路径

什么时候该用 --trusted-host？怎么配才不漏

它只是临时绕过，适合 CI/CD 调试或内网镜像源没配证书的场景。但必须注意：它不是“加在命令末尾就行”，每个要信任的域名都得单独写，且顺序要紧贴 -i 参数之后。

比如用清华源：pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ --trusted-host pypi.tuna.tsinghua.edu.cn requests
PyPI 官方实际涉及三个主机：pypi.org、files.pythonhosted.org、upload.pypi.org，缺一不可
长期使用请改配置文件：~/.pip/pip.conf（Linux/macOS）或 %APPDATA%\pip\pip.ini（Windows），写清楚每个 trusted-host 单独一行
IDE（如 PyCharm）会缓存解释器配置，升级 certifi 后不重启 Python 控制台，环境变量也不会生效