Go 不支持传统 OOP 的子类化与方法重写，但可通过组合 + 接口抽象或 RoundTripper 扩展实现安全、无侵入的 HTTP 行为定制，如自动添加请求头。
go 不支持传统 oop 的子类化与方法重写，但可通过组合 + 接口抽象或 roundtripper 扩展实现安全、无侵入的 http 行为定制，如自动添加请求头。
在 Go 中，试图通过结构体嵌入（如 type MyClient struct{ *http.Client }）并重定义 Do 方法来“继承” *http.Client，是一种常见但本质错误的思路。原因很明确：Go 没有子类化（subclassing）、没有虚函数表、没有运行时方法分发机制——*MyClient 和 *http.Client 是完全不同的类型，二者不满足赋值兼容性，即使 MyClient 嵌入了 *http.Client，它也不会自动实现 http.Client 的接口契约（因为 http.Client 本身不是接口，而是一个具体结构体），更无法被期望 *http.Client 类型的函数（如 github.NewClient）接受。
✅ 正确方案一：使用自定义 RoundTripper（推荐｜标准、安全、零侵入）
http.Client 的设计早已为扩展留出接口：其 Transport 字段类型为 http.RoundTripper —— 这是一个接口，定义了核心的 RoundTrip(*http.Request) (*http.Response, error) 方法。我们只需实现该接口，在调用底层 RoundTrip 前修改请求即可：
package trackerapi
import (
"net/http"
)
// HeaderRoundTripper 在每次请求前注入自定义 Header
type HeaderRoundTripper struct {
Base http.RoundTripper // 可传入 http.DefaultTransport 或其他实现
}
func (h *HeaderRoundTripper) RoundTrip(req *http.Request) (*http.Response, error) {
// 深拷贝 Header 避免并发修改风险（可选，但推荐）
req = req.Clone(req.Context())
req.Header.Set("Cache-Control", "max-stale=3600")
req.Header.Set("X-Tracker-Source", "go-tracker-api")
// 委托给底层 Transport
if h.Base == nil {
h.Base = http.DefaultTransport
}
return h.Base.RoundTrip(req)
}
// 使用示例
func NewTrackedClient() *http.Client {
return &http.Client{
Transport: &HeaderRoundTripper{},
}
}然后无缝传入 GitHub 客户端：
httpClient := trackerapi.NewTrackedClient() githubClient := github.NewClient(httpClient) // ✅ 编译通过，类型匹配
✅ 优势：符合 Go 设计哲学；复用标准
http.Transport；线程安全（RoundTrip是并发安全的）；无需修改任何第三方库代码。
❌ 为什么直接嵌入 *http.Client 并重写 Do 不可行？
-
http.Client.Do方法接收者是*http.Client，而MyClient.Do接收者是*MyClient，二者签名不同； - 即使你手动代理
my.Client.Do(req)，MyClient类型仍不等于*http.Client，Go 的类型系统严格禁止隐式转换； - 更严重的是：
http.Client内部还持有mu sync.RWMutex、jar *cookiejar.Jar等私有字段和逻辑，直接覆盖Do会绕过其内部状态管理（如重定向、超时、Cookie 处理），极易引发未定义行为。
✅ 方案二：包装函数（轻量级、适用于简单场景）
若仅需少量定制且不想引入新类型，可采用函数式包装：
func WithCacheControl(next http.Doer) http.Doer {
return doerFunc(func(req *http.Request) (*http.Response, error) {
req = req.Clone(req.Context())
req.Header.Set("Cache-Control", "max-stale=3600")
return next.Do(req)
})
}
type doerFunc func(*http.Request) (*http.Response, error)
func (f doerFunc) Do(req *http.Request) (*http.Response, error) {
return f(req)
}
// 使用
httpClient := &http.Client{}
trackedDoer := WithCacheControl(httpClient)
// 注意：github.NewClient 不接受 http.Doer，但部分现代 SDK（如 go-gitlab）已支持 —— 这正体现了接口抽象的价值⚠️ 注意：
github.com/google/go-github/v59/github当前仍要求*http.Client，因此此方案需配合方案一或 SDK 升级。
总结：Go 的“多态”靠接口，而非继承
| 概念 | Java/Python 风格 | Go 风格（推荐实践） |
|---|---|---|
| “继承” | class MyClient extends Client |
组合：嵌入字段 + 显式委托 |
| “方法重写” | @Override void do() |
接口实现：实现 RoundTripper 等契约 |
| “运行时绑定” | 虚函数表动态分发 |
接口变量：var t http.RoundTripper = &MyRT{}
|
记住一条黄金法则：*当你要“改变某个类型的行为”，优先查找它是否依赖接口；若有，实现该接口；若无（如 `http.Client），则寻找其可配置的接口字段（如Transport`），而非试图覆盖其方法。** 这既是 Go 的约束，更是其简洁性与可靠性的来源。
