go-vcr录制失败主因是recorder未注入http.Client.Transport；需显式设置Transport并确保磁带路径可写、存在且已提交至版本库，同时用BeforeSaveHook过滤敏感信息。
go-vcr 录制失败：磁带文件没生成，请求却走真实网络
这通常不是 bug，而是录制器没正确挂载到 http.Client 的 Transport 上。常见错误是创建了 recorder，但后续仍用默认客户端（如 http.Get）发请求，导致录制完全被绕过。
必须显式把录制器作为传输层注入：
rec, err := recorder.New("fixtures/login.yaml")
if err != nil {
t.Fatal(err)
}
defer rec.Stop()
client := &http.Client{
Transport: rec, // 关键：不能漏掉这行
}
resp, err := client.Get("https://api.example.com/login") // ✅ 被录制/回放
- 检查是否误用了
http.DefaultClient或未导出的内部客户端 - 确认
recorder.New()的路径可写，否则会静默失败（无 panic，但不生成文件） - 首次运行时若磁带文件不存在，go-vcr 默认进入录制模式；存在则自动切换为回放——别误以为“没反应”就是卡住了
回放时 404 或匹配失败：URL、Header、Body 全都对不上
go-vcr 默认只匹配 Method 和完整 URL.String()，任何细微差异都会导致找不到对应交互。比如查询参数顺序不同、多一个 trailing slash、Authorization 头存在与否，都会让匹配失败。
解决方式是自定义匹配器：
立即学习“go语言免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
rec.SetMatcher(func(r *http.Request, i cassette.Request) bool {
// 忽略查询参数顺序和 Authorization 头
u1 := cleanQuery(r.URL.String())
u2 := cleanQuery(i.URL)
return r.Method == i.Method && u1 == u2
})
- 不要直接比对原始
r.URL.String()，先用url.Parse标准化再拼接 - 如果请求体是 JSON，注意空格、换行、字段顺序——建议在匹配前统一
json.Marshal再比较 - 避免在测试中动态生成 timestamp、nonce 类参数；要么预设固定值，要么在匹配器里剔除
敏感信息泄露：API Key、Token 被明文写进 YAML 磁带文件
磁带文件是纯文本（YAML），一旦提交到 Git，密钥就永久暴露。go-vcr 提供钩子机制，在保存前擦除敏感字段。
最稳妥的做法是在录制阶段过滤：
rec.AddHook(func(i *cassette.Interaction) error {
delete(i.Request.Headers, "Authorization")
delete(i.Request.Headers, "X-API-Key")
if len(i.Request.Body) > 0 {
// 替换 body 中的 token 字段（假设是 JSON）
i.Request.Body = filterTokenFromBody(i.Request.Body)
}
return nil
}, recorder.BeforeSaveHook)
- 钩子类型选
BeforeSaveHook，确保磁带文件里从不存敏感内容 - 不要依赖
AfterCaptureHook，它发生在内存中捕获后，但尚未过滤就可能被日志打印出来 - 过滤逻辑要覆盖 request 和 response 两端——有些服务会在响应头里回传临时 token
CI 环境下测试失败：本地能过，流水线报错说 cassette 文件缺失
根本原因是磁带文件路径写死且未纳入版本管理，或 CI 工作目录与本地不一致。go-vcr 不会自动创建父目录，也不会提示 “fixtures/ not found” 这类友好错误。
- 磁带路径必须是相对路径（如
"fixtures/auth.yaml"），且确保fixtures/目录已git add并提交 - 在 CI 脚本里加一行检查：
ls -l fixtures/ || echo "fixtures dir missing!" - 避免使用
os.TempDir()或t.TempDir()作为磁带路径——回放依赖文件存在，临时目录每次清空就失效
真正麻烦的是跨平台路径分隔符和大小写敏感问题：Linux/macOS 下 Fixtures/ 和 fixtures/ 是不同目录，Windows 却不区分。统一全小写 + 斜杠，别用反斜杠。
