pytest中requests报SSLError是因SSL证书验证失败,常见于本地调用mock服务、内网HTTPS或容器缺CA证书;应通过session级fixture统一配置verify路径或禁用验证,而非全局禁用或逐处设verify=False。

为什么 pytest 运行时 requests 报 SSLError: certificate verify failed
这不是 pytest 本身的问题,而是你代码里或其依赖(比如用 requests.get() 调用内部 HTTPS 接口、mock 未覆盖的第三方请求)触发了 Python 默认的 SSL 验证。系统找不到可信 CA 证书,或目标服务用了自签名/过期/私有 CA 证书,requests 就会直接抛错中断测试。
常见于:本地开发环境调用测试用的 mock server(如 https://localhost:8001)、公司内网 HTTPS 服务、Docker 容器中缺失 CA 证书包。
- 别改全局
urllib3.disable_warnings()—— 它只抑制日志,不解决连接失败 - 别在每个
requests调用加verify=False—— 测试逻辑污染严重,且会漏掉真正该报错的场景 - pytest 的
requests钩子不存在 ——requests没提供 pytest 原生钩子,得靠 fixture 或 session 级配置
用 pytest fixture 统一控制 requests 的 verify 行为
最干净的方式是定义一个作用域为 session 的 fixture,在测试启动时替换 requests.Session.verify 的默认值,或注入自定义 verify 路径。这样所有通过 requests 发出的请求(包括间接调用)都会受控。
示例(放在 conftest.py 中):
立即学习“Python免费学习笔记(深入)”;
import pytest import requests <p>@pytest.fixture(scope="session", autouse=True) def disable_ssl_verification():</p><h1>仅用于开发/测试环境,切勿在 CI 或生产测试中启用</h1><pre class="brush:php;toolbar:false;">requests.packages.urllib3.disable_warnings() requests.Session.verify = False
如果需要指定证书路径(比如你有公司根证书 /etc/ssl/certs/company-ca.pem):
@pytest.fixture(scope="session", autouse=True)
def set_custom_ca_bundle():
import os
os.environ["REQUESTS_CA_BUNDLE"] = "/etc/ssl/certs/company-ca.pem"
# 或直接赋值给 Session 类(更可靠)
requests.Session.verify = "/etc/ssl/certs/company-ca.pem"
- 务必加
autouse=True,否则 fixture 不会自动生效 -
scope="session"确保整个测试会话只设置一次,避免重复覆盖 - 不要在测试函数里手动改
requests.Session.verify—— 它是类属性,改了会影响后续所有请求,包括其他测试用例
requests.verify=False 为什么有时仍报 SSL 错误?
因为有些库绕过了 requests.Session,比如直接用 urllib.request.urlopen()、httpx、或底层用 ssl.create_default_context() 的 SDK(如 boto3、aiobotocore)。此时仅改 requests 不够。
通用兜底方案(仍放 conftest.py):
import ssl from urllib3.util.ssl_ import create_urllib3_context <h1>禁用所有 urllib3 发起的 SSL 验证(requests 底层依赖它)</h1><p>try: _create_default_https_context = ssl._create_default_https_context ssl._create_default_https_context = ssl._create_unverified_context except AttributeError:</p><h1>Python < 2.7.9</h1><pre class="brush:php;toolbar:false;">pass
强制 urllib3 使用非验证上下文
class CustomHTTPAdapter(requests.adapters.HTTPAdapter): def init_poolmanager(self, *args, *kwargs): kwargs['cert_reqs'] = 'CERT_NONE' return super().init_poolmanager(args, **kwargs)
@pytest.fixture(scope="session", autouse=True) def use_insecure_adapter(): session = requests.Session() session.mount('https://', CustomHTTPAdapter())
注意:这不会自动替换 pytest 全局 Session,需配合 monkeypatch 或显式使用该 session
- 第一段(
ssl._create_default_https_context替换)影响面最广,但属于“核弹级”操作,慎用于共享测试环境 - 第二段
CustomHTTPAdapter更精准,但只对显式使用该Session实例的请求生效 - 如果你用的是
httpx,得单独配httpx.Client(verify=False)或设环境变量SSL_NO_VERIFY=1
CI 环境中证书问题更隐蔽,优先检查这些点
Docker 镜像、GitHub Actions runner、GitLab CI 的 Alpine/Ubuntu 基础镜像常缺少完整 CA 证书包,导致 verify=True 时连公网 API(如 https://httpbin.org)都失败。
- Alpine 镜像:运行
apk add --no-cache ca-certificates并执行update-ca-certificates - Debian/Ubuntu:确保安装了
ca-certificates包,且/etc/ssl/certs/ca-certificates.crt存在且非空 - GitHub Actions:Ubuntu runner 默认有证书,但自定义 Docker container 可能没继承;用
run: openssl version -d查看 OpenSSL 默认 cert 目录 - 永远不要在 CI 中设
verify=False—— 这会让证书过期、域名不匹配等真实问题被掩盖
真正难处理的不是怎么关掉验证,而是如何让测试既跑得通,又不丧失对证书异常的感知能力 —— 所以推荐分环境配置:本地开发允许 verify=False,CI 必须走真实证书链校验,并把证书路径纳入构建流程管理。


















