现象:代码昨天还能跑,今天所有 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 裁掉,精简镜像经常因此出问题。判断顺序建议固定下来:先换目标域名、再换网络环境、最后才怀疑证书库,能少走很多弯路。
