如何解决Python测试中SSL证书验证失败问题_配置pytest的request钩子

夜杰酱_8559

夜杰酱_8559

2026-05-10

359人浏览

原创

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

如何解决python测试中ssl证书验证失败问题_配置pytest的request钩子

为什么 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 中):

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):

testing-python
testing-python

使用pytest编写和评估有效的Python测试。适用于编写测试、审查测试代码、调试测试失败或提高测试覆盖率。

下载
@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 <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 必须走真实证书链校验,并把证书路径纳入构建流程管理。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

python ssl

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1671

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

4224

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1669

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

24497

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2987

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3027

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1163

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

596

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2343

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程