4. 回放测试原理：请求录制与回放、VCR模式、与契约测试的异同

回放测试是契约测试驱动报表导出场景中的核心执行机制。它通过“录制-回放”技术，将真实环境中的HTTP交互捕获为静态数据，在后续测试中模拟相同的服务行为，从而消除对下游不稳定依赖的耦合。本章深入剖析其工作原理、VCR模式实现，并与契约测试进行系统性对比。

4.1 请求录制与回放的核心流程

回放测试的本质是“一次录制，多次回放”。在报表导出场景中，前端或测试夹具向报表服务发起请求，中间代理层拦截该请求并转发给真实下游；同时，代理将请求与响应序列化存储为“磁带（Cassette）”文件。后续测试运行时，代理匹配请求并直接返回磁带中的响应，不再调用真实服务。

4.1.1 录制阶段（Record Phase）

1. 启动代理： 测试框架启动一个本地HTTP代理或中间件（如 VCR.py、Ruby VCR、Polly.js）。
2. 拦截请求： 代理捕获所有出站HTTP请求（方法、URL、Headers、Body）。
3. 转发并记录： 请求被转发到真实下游服务；响应返回后，代理将请求-响应对序列化为YAML/JSON格式的磁带文件。
4. 存储磁带： 磁带文件按测试用例或场景命名，存储在项目指定目录（如 cassettes/）。

4.1.2 回放阶段（Replay Phase）

1. 加载磁带： 测试启动时，代理根据上下文加载对应的磁带文件到内存。
2. 拦截请求： 再次捕获出站请求。
3. 匹配请求： 代理使用匹配器（默认精确匹配Method + URI + Body）在磁带中查找对应条目。
4. 返回桩响应： 若匹配成功，直接返回磁带中存储的响应（状态码、Headers、Body），不发起真实网络调用。
5. 匹配失败处理： 若未匹配，根据策略抛出错误或降级为真实请求（需谨慎）。

4.2 VCR模式详解

VCR（Video Cassette Recorder）模式是回放测试最流行的实现范式，得名于其“像录像带一样记录和重放HTTP交互”的隐喻。主流实现包括 Ruby VCR、Python VCR.py、JavaScript Polly.js 等。VCR模式定义了三种运行模式，控制测试与真实服务的交互策略。

4.2.1 匹配器（Matcher）策略

VCR默认使用精确匹配（Method + URI），但在报表导出场景中，请求参数可能包含随机token或分页偏移量。此时需要自定义匹配器：

# Python VCR.py 自定义匹配器示例
import vcr

def custom_matcher(r1, r2):
    # 忽略查询参数中的 'timestamp' 和 'nonce'
    from urllib.parse import urlparse, parse_qs
    uri1 = urlparse(r1.uri)
    uri2 = urlparse(r2.uri)
    params1 = {k: v for k, v in parse_qs(uri1.query).items() if k not in ['timestamp', 'nonce']}
    params2 = {k: v for k, v in parse_qs(uri2.query).items() if k not in ['timestamp', 'nonce']}
    return (r1.method == r2.method and 
            uri1.path == uri2.path and 
            params1 == params2)

with vcr.use_cassette('cassettes/report_export.yml', 
                       match_on=[custom_matcher]):
    response = client.get('/api/report/export?format=pdf×tamp=12345')

4.3 回放测试与契约测试的异同

回放测试和契约测试都致力于解决服务间依赖问题，但二者的关注点、验证粒度、数据来源有本质区别。理解这些差异，有助于在报表导出场景中合理搭配使用。

4.3.1 核心差异对比表

4.3.2 协同策略：何时用回放，何时用契约

• 契约测试优先： 在开发阶段，使用Pact定义报表导出接口的消费者契约，确保前端/测试夹具发送的请求符合提供者期望。契约测试在CI中快速验证接口协议。
• 回放测试补充： 在回归测试阶段，使用VCR录制真实报表服务的响应，验证整个导出流程的端到端数据完整性。回放测试捕获真实响应中的边界值、错误码和性能特征。
• 混合模式： 先通过契约测试保证接口协议正确，再通过回放测试保证数据内容正确。二者形成“协议 + 数据”的双层验证体系。