正确做法是直接安装核心库composer require php-vcr/php-vcr:^1.7，因php-vcr-bundle非官方、未发布于packagist且已多年未更新；symfony项目需手动注册服务并调用vcr::turnon()启用录制。
Composer 安装 php-vcr-bundle 失败或找不到包？
因为 php-vcr-bundle 并不是官方维护的 Symfony Bundle，也没有发布在 Packagist 上——它实际是 php-vcr/php-vcr 的一个非官方、已多年未更新的 Symfony 封装（最后 commit 在 2016 年），所以直接 composer require php-vcr-bundle 会报 Could not find package php-vcr-bundle。
正确做法是绕过 Bundle 层，直接安装核心库：
- 运行
composer require php-vcr/php-vcr:^1.7（注意：v1.7 是最后一个兼容 PHP 7.4+ 的稳定版） - 不要尝试
composer require php-vcr-bundle或php-vcr/symfony-bundle，这些包不存在或已归档 - 若项目用 Symfony 5+/6+，需手动注册服务和配置，不能依赖自动加载的 Bundle
在 Symfony 中手动注册 VCR 服务并启用录制
PHP-VCR 默认不提供 Symfony 集成层，必须自己定义服务并确保在测试环境启用。常见错误是录制没生效，请求仍打到真实 API。
在 config/services_test.yaml 中添加：
services:
vcr.cassette:
class: 'VCR\VCR'
public: true
calls:
- ['configure', [{ 'cassette_path': '%kernel.project_dir%/tests/Fixtures/vcr' }]]
然后在测试用例中显式启动：
- 调用
VCR::turnOn()（必须在setUp()中，不能只靠 autoloading） - 用
VCR::insertCassette('my_api_call')开始录制；VCR::eject()结束 - 确保
php-vcr的 stream wrapper 已启用：stream_wrapper_register('vcr', 'VCR\StreamWrapper')—— 这步由VCR::turnOn()自动完成，但若提前用了file_get_contents()等函数则可能失效
录制时 HTTP 请求仍发出？检查 cURL 和 Guzzle 兼容性
PHP-VCR 对 cURL 的拦截依赖于 curl_setopt_array() 和 curl_exec() 的 hook，但它不支持 Guzzle 7+ 的默认 handler（HttpClient 使用 curl 但绕过了传统 hook 点）。
解决办法分场景：
- 用原生
cURL或file_get_contents()：直接兼容，无需额外配置 - 用 Guzzle 6.x：传入
['handler' => \GuzzleHttp\Handler\CurlHandler::class]，确保走 cURL 路径 - 用 Guzzle 7+/8+：必须降级到 Guzzle 6，或改用
php-vcr的guzzle-handler扩展（需额外composer require php-vcr/guzzle-handler，且仅支持 Guzzle 7.4 以下） - 使用 Symfony HttpClient：PHP-VCR **完全不支持**，它基于
curl和stream层，而Symfony\Contracts\HttpClient\HttpClientInterface是独立实现，必须换回 cURL/Guzzle 6 或改用其他录制方案（如httplug/vcr-plugin）
录制生成的 cassette 文件乱码或无法重放？
生成的 JSON cassette 文件里 body 是 base64 编码的，但常见问题是响应头缺失、gzip 压缩未解压、或时间戳导致 diff 失败。
关键配置项要显式设好：
- 在
VCR::configure()中加'ignore_hosts' => ['localhost']，避免误录本地调试请求 - 设
'record_requests' => true和'record_responses' => true（默认开启，但某些旧版本需显式） - 禁用动态字段干扰：
'preserve_exact_body_bytes' => true防止 UTF-8 BOM 或换行符归一化 - 录制后手动打开 cassette 文件，确认
response.body.string字段可读；若为null，说明 body 被跳过——常见于流式响应或 chunked transfer，此时需在录制前设置curl_setopt($ch, CURLOPT_RETURNTRANSFER, true)
真正麻烦的是跨环境时间戳、nonce、签名字段，这些没法靠 VCR 自动抹除，得在 cassette 加载后用 VCR::beforePlayback() 注册回调做正则替换。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
