如何在Python中用pytest-vcr录制并回放HTTP请求-Python教程-PHP中文网

根本原因是请求未被真正录制或回放时匹配失败；vcrpy默认只拦截requests，对httpx、urllib等无效，且URL参数、headers、body严格匹配易导致fallback至真实请求。

如何在python中用pytest-vcr录制并回放http请求

为什么 pytest-vcr 录制后回放总是报 404 或连接拒绝？

根本原因通常是请求没被真正录制，或回放时匹配逻辑失败。pytest-vcr 默认只拦截 requests（不含 httpx、urllib 原生调用），且对 URL 查询参数、headers、body 的匹配是严格默认开启的。如果你用的是 httpx 或手动构造了 urllib.request.Request，vcrpy 根本看不到请求，自然不会存 cassette，回放时就直连真实服务——此时若服务不可达或地址变了，就会报连接错误或 404。

实操建议：

确认 HTTP 客户端：只对 requests 开箱即用；用 httpx 需额外装 pytest-httpx 或改用 vcrpy 的 register_matcher + 自定义适配器
检查 cassette 文件是否生成：运行测试加 --vcr-record=once 后，看 cassettes/ 目录下是否有对应 YAML 文件；没有就说明没触发录制
临时关闭严格匹配：在 @vcr.use_cassette 中加 match_on=["method", "uri"]，排除 headers/body 干扰
避免动态参数：URL 中带时间戳、随机 UUID、token 会导致每次请求 URI 不同，匹配失败；用 filter_query_parameters 清洗掉

如何正确配置 pytest-vcr 的 conftest.py 和 fixture？

不靠全局 pytest_configure 硬编码路径，而是用 fixture 统一管理 cassette 生命周期，更可控、易测、可复用。

实操建议：

在项目根目录下建 conftest.py，内容包含：

import pytest
import vcr
<p>@pytest.fixture
def vcr_cassette_dir(request):</p><h1>把 cassette 存到 tests/cassettes/ 下，按模块+函数名组织</h1><pre class="brush:php;toolbar:false;">return f"tests/cassettes/{request.module.__name__}"

@pytest.fixture def vcr_config(): return { "record_mode": "once", "cassette_library_dir": "tests/cassettes", "filter_query_parameters": ["api_key", "timestamp", "signature"], "ignore_localhost": True, "decode_compressed_response": True, }

测试文件里直接用 @pytest.mark.vcr（无需参数）即可自动读取配置和路径
如需单测覆盖不同行为，可在测试函数上加 @pytest.mark.vcr(record_mode="all") 强制重录

录制时遇到 SSL 验证失败或证书警告怎么办？

不是代理问题，也不是 pytest-vcr 的 bug，而是 vcrpy 在录制阶段仍会走真实 HTTPS 握手——如果目标站点证书异常（如自签名、过期）、或系统缺少根证书（常见于 Docker Alpine 镜像），就会抛 SSLError 或警告，导致录制中断。

Secure Python Code Sandbox

安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。

下载

实操建议：

开发环境可临时禁用验证（仅限录制）：在 vcr_config 中加 "custom_patches": [("requests.adapters.HTTPAdapter.send", lambda *a, **kw: setattr(kw, "verify", False) or kw)] ——但更推荐下面方式
稳妥做法：用 pytest-vcr 的 allow_hosts + ignore_hosts 控制范围，配合系统级证书修复（如 apk add ca-certificates）
绝对不要在回放阶段关 SSL 验证：回放本不该发真实请求，关了反而掩盖了“本该走 cassette 却直连”的 bug

回放失败但 cassette 明明存在？重点查这三处

YAML 文件存在 ≠ 能成功匹配。vcrpy 匹配失败时静默 fallback 到真实请求，你看到的错误其实是下游服务返回的，不是 vcr 的报错。

排查顺序：

打开 cassette 文件，确认 interactions 数量 ≥ 1，且 request.method 和 request.uri 与代码中一致（注意 trailing slash、大小写、编码）
在测试中加 print(vcr.get_active_cassette().play_count)，回放后为 0 就说明完全没匹配上
启用 debug 日志：export VCR_LOG_LEVEL=DEBUG，运行测试看日志里是否出现 Match failed for request... 及具体 mismatch 字段

最常被忽略的是 body 内容差异：POST JSON 中字段顺序、空格、换行符、浮点数精度都可能导致哈希不等。用 match_on=["method", "uri", "body"] 前先确认 body 确实稳定；否则建议过滤掉非关键字段或用 before_record_request 归一化。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！