2026年生产环境必须弃用hystrix-go，因其已归档、原子计数竞争致熔断失效、不支持context透传；应迁移至sony/gobreaker，它无依赖、兼容context、状态机可靠且需按服务隔离实例。
2026 年生产环境别用 hystrix-go，它已归档、有原子计数竞争风险、不支持 context 透传——该切到 sony/gobreaker。
为什么 hystrix-go 在 2026 年不该再用了
hystrix-go 早在 2023 年就进入归档状态，官方不再维护。在 Go 1.21+ 环境下，它的 RequestVolumeThreshold 和 SleepWindow 等关键配置在高并发时会因原子计数器竞争而失效；更严重的是，它完全不支持 context.Context 透传，导致超时无法真正中断底层 HTTP 请求，极易引发 goroutine 泄漏和长尾堆积。你看到的“熔断生效”，可能只是表象——背后请求还在 hang 着。
gobreaker 基于标准 sync/atomic 实现状态机，无外部依赖，ReadyToTrip 和 OnStateChange 可定制，且天然兼容 context。这不是“可选升级”，而是必须迁移。
gobreaker 的 fallback 不是自动触发的
很多人传了 fallback 函数，却没进降级逻辑，原因是误解了触发条件：cb.Execute 的第三个参数（fallback）只在两种情况下执行：一是熔断器处于 gobreaker.ErrOpenState，二是主函数 panic。它不会因为主函数返回 error（比如 net/http: request canceled 或 dial tcp: i/o timeout）就跳进去。
立即学习“go语言免费学习笔记（深入）”；
- 主函数返回 error → 计入失败统计，但不走 fallback
- 主函数 panic → 走 fallback
- 熔断器状态为 Open → 直接返回
gobreaker.ErrOpenState，走 fallback
正确写法：
result, err := cb.Execute(
func() (interface{}, error) {
resp, err := http.DefaultClient.Do(req)
if err != nil {
return nil, err // 网络层错误直接透出
}
if resp.StatusCode >= 500 {
return nil, fmt.Errorf("server error: %d", resp.StatusCode) // 主动转 error
}
return resp, nil
},
func(err error) interface{} {
return getFallbackUser() // 这里才是真正的降级入口
},
)
每个下游服务必须配独立的 CircuitBreaker 实例
复用同一个 gobreaker.CircuitBreaker 实例去包 user-service、order-service、payment-service，等于把所有故障源绑在同一根保险丝上。A 服务挂了，B 服务跟着被熔断，这就是典型的故障污染。
必须按依赖维度隔离：
- 为每个下游服务新建一个
gobreaker.CircuitBreaker，名字带标识（如"user_service"、"order_service"） - 配置参数按服务 SLA 差异化设置：核心服务可设更低失败阈值（如连续 3 次失败即熔断），非核心可放宽
- 在 Prometheus 中用
breaker标签区分指标，否则监控看板全是马赛克
HTTP 调用必须先做 context 超时，再进熔断
熔断器的 Timeout 字段只控制 cb.Execute 等待主函数返回的时间，它不会中断正在运行的 http.Do。如果你只靠熔断器超时，800ms 的网络 hang 会卡满整个 goroutine，直到熔断器自己 timeout（比如设了 10s）才返回——这已经晚了。
正确顺序是：
- 用
ctx, cancel := context.WithTimeout(r.Context(), 800*time.Millisecond)创建 request-level 上下文 - 把
ctx传给http.Request.WithContext(ctx)，确保超时后连接真正关闭 - 熔断器的
Timeout设为略长（如 10s），让它成为第二道防线，而非第一道 - 在 defer 中调用
cancel()，避免 context 泄漏
降级数据要带业务语义：返回 "Default User" 可能导致前端渲染崩溃或埋点错乱；应该返回缓存的上一次成功响应（带 stale 标识）、或结构体字段全零但类型安全的兜底值。
