讲师中心 微信公众号
AI工具推荐 视频效率加速

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

夜杰酱_8559

夜杰酱_8559

发布时间:2026-05-10 10:00:47

|

359人浏览过

|

来源于php中文网

原创

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

立即学习“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

testing-python
testing-python

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

下载

如果需要指定证书路径(比如你有公司根证书 /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 必须走真实证书链校验,并把证书路径纳入构建流程管理。

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

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

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

1671

2023.07.20

python能做什么
python能做什么

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

4204

2023.07.25

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

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

1669

2023.07.31

python教程
python教程

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

24357

2023.08.03

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

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

2987

2023.08.04

python eval
python eval

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

3007

2023.08.04

scratch和python区别
scratch和python区别

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

1163

2023.08.11

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

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

596

2023.08.10

FrankenPHP集成Laravel详细教程
FrankenPHP集成Laravel详细教程

本专题提供FrankenPHP集成Laravel的详细配置指南,全面解析运行原理、开发环境搭建、Caddyfile配置、Octane工作模式、数据库连接、队列任务、定时任务和生产环境优化,解决部署过程中常见的报错与兼容性问题。

0

2026.10.08

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn