gobreaker 是 Go 生产环境最轻量可控的熔断器，需为不同服务配置独立实例，通过 cb.Execute() 包装调用，合理设置 Interval、Timeout 和 ReadyToTrip 阈值，并配套监控状态。
gobreaker 是当前 Go 生产环境里最轻量、最可控的熔断器实现，新项目别碰 hystrix-go——它已归档，且状态机设计僵硬，容易在并发探测时误判。
用 go mod 初始化并引入 gobreaker
确保你已在项目根目录执行过 go mod init your-module-name，然后直接加依赖：
go get github.com/sony/gobreaker
不需要额外初始化或全局注册，每个熔断器实例彼此隔离。常见错误是把它当单例全局复用——不同下游服务（比如订单 vs 用户中心）必须配独立熔断器，否则失败率互相污染。
-
gobreaker.Settings.Name必须唯一，用于日志和监控区分 - 不要把
Timeout设成0或过长（如5 * time.Minute），否则半开状态永远不触发试探请求 -
Interval是统计窗口，不是“熔断多久”，它决定失败率计算周期；太短（如1 * time.Second）会导致抖动误熔，太长（如5 * time.Minute）会让恢复变慢
包装 HTTP 调用：必须用 cb.Execute()，不能手写状态流转
熔断器只在 cb.Execute() 内部感知成功/失败，并自动更新状态。如果你在外面捕获 error 后手动调 cb.OnError()，会跳过状态机关键逻辑，比如连续失败计数重置、半开试探调度等。
立即学习“go语言免费学习笔记（深入）”；
正确写法示例：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
result, err := cb.Execute(func() (interface{}, error) {
ctx, cancel := context.WithTimeout(context.Background(), 800*time.Millisecond)
defer cancel()
resp, err := http.DefaultClient.Do(req.WithContext(ctx))
if err != nil {
return nil, err
}
defer resp.Body.Close()
return io.ReadAll(resp.Body)
})- 超时必须放在
Execute闭包内，否则熔断器无法把超时识别为失败信号 - 返回值类型必须是
(interface{}, error)，不能省略interface{}占位；若无实际返回，用nil即可 - 不要在闭包里做重试——熔断器不处理重试，那是
backoff库的事；重试应在Execute外层或降级逻辑中做
配置阈值：避开“连续失败即熔断”这个经典坑
很多团队把 ReadyToTrip 写成 counts.ConsecutiveFailures > 1，结果一次网络抖动就熔断 30 秒，业务毛线都掉光。真实场景需要兼顾灵敏度与容错弹性。
推荐起始配置（适用于中等 QPS 的核心接口）：
-
MaxRequests: 5—— 半开状态下最多放行 5 个试探请求 -
Interval: 30 * time.Second—— 每 30 秒滚动统计失败率 -
Timeout: 20 * time.Second—— 熔断打开后等待 20 秒再进半开 -
ReadyToTrip: func(counts gobreaker.Counts) bool { return counts.TotalRequests >= 10 && float64(counts.Failures)/float64(counts.TotalRequests) > 0.6 }—— 至少 10 次调用，且失败率超 60%
注意：ConsecutiveFailures 容易被误导——它只记连续失败次数，不反映整体质量；而 TotalRequests + Failures 才能体现真实健康度，更适合稳态服务。
降级逻辑必须轻量，且不能依赖另一个可能熔断的服务
降级不是兜底大法，而是快速止损。典型错误是降级时再去查 Redis 或调另一个 HTTP 接口，结果把降级路径也拖垮。
- 优先返回本地缓存（如
sync.Map存的最近成功响应） - 次选静态默认值（如空数组、
"service_unavailable"字符串） - 绝对避免在降级函数里再套一层
cb.Execute()或limiter.Wait() - 如果必须异步补偿（如记录失败事件），用
go func() { ... }()启动 goroutine，但要控制数量，防堆积
最难被注意到的一点：熔断器本身不记录日志，也不暴露指标。上线前务必用 cb.ReadyState() 定期采样状态，再打到 Prometheus 或写入日志——否则出问题时你连它是不是开了都不知道。
