本文介绍通过替换 http.DefaultClient 并自定义 RoundTripper 实现对 http.Head() 的可控模拟，从而覆盖网络错误等边界场景的单元测试需求。
本文介绍通过替换 `http.defaultclient` 并自定义 `roundtripper` 实现对 `http.head()` 的可控模拟，从而覆盖网络错误等边界场景的单元测试需求。
在 Go 中，http.Head(url) 并非底层系统调用，而是对 http.DefaultClient.Head() 的封装。这意味着它完全依赖于全局变量 http.DefaultClient 的行为——而该客户端默认使用 http.DefaultTransport（即基于网络的真实传输）。因此，直接“mock 函数”在 Go 中不可行（无函数重写机制），但可通过依赖注入或全局客户端替换实现等效效果。
最推荐、最符合 Go 测试惯例的方式是：在测试前临时替换 http.DefaultClient 为一个使用自定义 RoundTripper 的客户端，并在测试后恢复原值。这样所有经由 http.Head、http.Get 等标准库函数发起的请求，都会流经你的可控逻辑。
以下是一个完整、可复用的测试示例：
package main
import (
"errors"
"net/http"
"net/http/httptest"
"testing"
)
// testRoundTripper 是一个可配置的 RoundTripper，用于模拟不同 HTTP 行为
type testRoundTripper struct {
StatusCode int
Err error
}
func (t *testRoundTripper) RoundTrip(req *http.Request) (*http.Response, error) {
if t.Err != nil {
return nil, t.Err
}
// 返回预设状态码的响应（Body 为空，符合 HEAD 语义）
return &http.Response{
StatusCode: t.StatusCode,
Body: http.NoBody,
Header: make(http.Header),
}, nil
}
func TestCheckReleaseStatus_HeadError(t *testing.T) {
// 1. 保存原始 DefaultClient
originalClient := http.DefaultClient
defer func() { http.DefaultClient = originalClient }()
// 2. 替换为返回错误的客户端（模拟网络失败）
http.DefaultClient = &http.Client{
Transport: &testRoundTripper{Err: errors.New("network timeout")},
}
// 3. 执行被测逻辑（例如 outyet 中的 checkReleaseStatus）
// 假设该函数内部调用了 http.Head(...)
// result := checkReleaseStatus("https://example.com")
// 4. 断言日志是否捕获了预期错误（例如通过 testutil.CaptureStderr 或 zap-tester）
// 此处省略具体断言，重点在于错误路径已被触发
}✅ 关键要点与注意事项：
- 必须恢复 http.DefaultClient：使用 defer 确保即使测试 panic 也能还原，避免污染其他测试。
- RoundTrip 返回 http.NoBody：HEAD 请求不应有响应体，显式使用 http.NoBody 符合规范且节省内存。
- 避免真实网络调用：此方法彻底隔离外部依赖，保证测试快速、稳定、可重复。
- 进阶建议：生产级测试可结合 net/http/httptest 启动本地 mock server（如 httptest.NewServer），适用于需验证请求头、路径等细节的场景；但对于仅需控制返回状态或错误的单元测试，自定义 RoundTripper 更轻量、更直接。
- 警惕并发风险：若测试并行执行（t.Parallel()），请勿共享 http.DefaultClient 替换逻辑——应改用显式传入 *http.Client 参数的方式（即重构被测代码，实现真正的依赖注入）。
总结：Mock http.Head() 的本质是控制其底层 HTTP 客户端行为。通过安全地替换 http.DefaultClient.Transport，你既能精准模拟成功响应、各种 HTTP 状态码，也能可靠触发错误分支，显著提升测试覆盖率与健壮性。
