直接用 hystrix.Do 会 panic 是因为未初始化配置，新版需为每个 command 显式传入非零 hystrix.Settings（至少设 Timeout 和 MaxConcurrentRequests），否则访问零值结构体导致 nil pointer dereference。
为什么直接用 hystrix.Do 会 panic：nil pointer dereference
因为 hystrix.ConfigureCommand 或默认配置未初始化，hystrix.Do 内部会访问未初始化的全局 registry，导致 panic。这不是你代码写错了，是没提前 setup。
正确做法是：在 main() 开头或服务启动时调用 hystrix.Init（已废弃）或更推荐的显式配置——但其实最新版 hystrix-go（v0.2+）已移除全局 init，必须为每个 command 显式传入 hystrix.Settings，否则用的是零值结构体，超时、熔断阈值全为 0，等效于不生效。
- 别依赖文档里老的 “调一次
hystrix.ConfigureCommand就全局生效” 示例，那是 v0.1 的行为 - 每个
hystrix.Do调用前，务必传入非零hystrix.Settings，至少设Timeout和MaxConcurrentRequests - 常见错误现象：
panic: runtime error: invalid memory address or nil pointer dereference，堆栈指向hystrix.go:xxx—— 八成是 settings 为空
如何给 HTTP client 请求套上熔断器：不是包装 http.Client，而是包装业务逻辑函数
hystrix-go 不是中间件，也不劫持 transport；它要求你把「可能失败的外部调用」封装成一个无参函数，交给 hystrix.Do 执行。所以不是改 http.Client，而是改你发请求的那几行代码。
比如调用下游订单服务：
立即学习“go语言免费学习笔记（深入）”；
resp, err := hystrix.Do("order-service-get", func() (interface{}, error) {
req, _ := http.NewRequest("GET", "https://order.svc/api/v1/order/123", nil)
resp, err := httpClient.Do(req)
if err != nil {
return nil, err
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
return body, nil
}, func(err error) (interface{}, error) {
// fallback：返回缓存、默认值或降级响应
return []byte(`{"status":"fallback"}`), nil
})
-
"order-service-get"是 command name，必须唯一且有意义，用于 metrics 和 dashboard 识别 - fallback 函数不能 panic，且返回类型需与主函数一致（
interface{}+error） - 别在主函数里做 JSON 解析或 DB 操作——熔断只管“调用本身”，业务逻辑后置处理
- 如果下游是 gRPC，同样把
client.GetXXX(ctx, req)包进匿名函数里
熔断器不触发？检查这三个参数是否合理设置
熔断生效依赖三个关键阈值：错误率、窗口时间、最小请求数。默认值（ErrorPercentThreshold=50, RequestVolumeThreshold=20, Timeout=1000 ms）在高并发或低延迟场景下极易失效。
-
RequestVolumeThreshold：窗口内请求数低于此值，熔断器永远不计算错误率。QPS 低的服务建议降到5或10 -
ErrorPercentThreshold：注意是“错误数 / 总请求数”，不是连续错误。若下游偶发 5xx，但每分钟只 3 次请求，永远达不到阈值 -
Timeout必须小于你对下游的 SLA —— 比如下游承诺 P99 1000 就太松；设600更合理，避免拖慢本服务 - 别忽略
SleepWindow（默认 15s）：熔断后多久尝试半开。压测时频繁失败又快速恢复，可能就是这个值太小，反复震荡
如何观测熔断状态：不用额外埋点，直接读 hystrix.GetCircuit
每个 command name 对应一个独立熔断器实例，状态可实时查询。调试或告警时，比日志更准：
circuit, _ := hystrix.GetCircuit("order-service-get")
fmt.Printf("IsOpen: %v, Requests: %d, Errors: %d\n",
circuit.IsOpen(), circuit.Metrics().Requests, circuit.Metrics().Errors)
- 返回的
circuit是指针，可能为nil（command 还没被调用过），记得判空 -
circuit.Metrics()返回的是快照，不是原子计数器，适合采样上报，不适合精确计数 - 生产环境建议每分钟拉一次关键 command 的
IsOpen和Errors，推送到 Prometheus 或告警系统 - Dashboard（
hystrix-dashboard）已停止维护，别花时间配它；用GetCircuit+ 自定义指标更可控
