Python requests 报 SSLError certificate verify failed 怎么解决

现象:代码昨天还能跑,今天所有 HTTPS 请求都失败

用 requests 请求接口,抛出 SSLError: HTTPSConnectionPool ... certificate verify failed: unable to get local issuer certificate。浏览器打开同一个地址却是正常的,换成 http 也能通,只有 Python 里报证书错误。

原因:Python 用的证书库和浏览器不是一套

  • certifi 缺失或过期。requests 默认用 certifi 里的根证书,用 python.org 安装包在 macOS 上还经常需要手动执行一次证书安装脚本。
  • 目标站点用的是自签或内网 CA,这类证书本来就不在公共根证书列表里。
  • 公司代理做了中间人解密,返回的是企业自己签发的证书,本机没导入企业根证书就校验失败。
  • 系统时间偏差过大,证书被判为未生效或已过期。

解决步骤

第一步,先确认是不是全站失败。只有一个域名失败,基本就是自签或代理问题;所有 https 都失败,才轮到 certifi。

pip install -U certifi
python -c "import certifi; print(certifi.where())"

第二步,自签或内网证书显式指定 CA,这是正确的解法:

import requests
r = requests.get(url, verify="/etc/ssl/my-ca.crt",
                 timeout=10)

第三步,全局生效时用环境变量,适合大量脚本都不想逐个改的情况:

export REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt

第四步,检查代理链路。确认 HTTPS_PROXY 指向的代理是否需要额外信任;企业环境要让运维提供根证书,导入后再请求。

不要用 verify=False 图省事,它只是跳过校验并打印警告,等于关掉了防中间人攻击的能力,上线后很难再改回来。

小结

先分清"全站失败"还是"单站失败",前者升级 certifi,后者补 CA 证书路径。真证书路径永远比关校验可靠。

在 macOS 上用 python.org 的安装包,还要单独双击执行 Applications/Python 目录下的 Install Certificates.command,否则 certifi 装好了也不会被用上;在 Docker 镜像里则注意不要把系统 ca-certificates 裁掉,精简镜像经常因此出问题。判断顺序建议固定下来:先换目标域名、再换网络环境、最后才怀疑证书库,能少走很多弯路。

您可以还会对下面的文章感兴趣: