Iris 默认不带熔断中间件，因其设计哲学强调轻量与显式控制，熔断降级需开发者自行选型（如gobreaker）并封装为中间件，每个业务接口应配置独立熔断器实例以避免状态干扰。
为什么 Iris 默认不带熔断中间件
Iris 是一个 Go 语言 Web 框架，它本身不内置熔断器（circuit breaker）或降级逻辑，也不像 Spring Cloud 那样集成 Hystrix 或 Sentinel。它的设计哲学是轻量、可控、由开发者显式组合能力——熔断降级必须靠你自己选型 + 编写中间件，或集成第三方库（如 gobreaker、resilience-go）封装成中间件。
用 gobreaker 实现请求级熔断中间件
gobreaker 是最常用的 Go 熔断库，状态机清晰、无依赖、支持自定义失败判定。把它包装成 Iris 中间件的关键点是：拦截 handler 执行、捕获 panic/错误、更新熔断器状态、按需跳过真实 handler。
- 安装：
go get github.com/sony/gobreaker - 为每个需要保护的路由路径或 handler 创建独立的
gobreaker.CircuitBreaker实例（避免不同接口共用状态） - 在中间件中调用
cb.Execute包裹原始 handler 的执行，而非直接调用ctx.Next() - 失败判定函数要明确：比如只把
context.DeadlineExceeded或特定 HTTP 状态码（如 502/503）视为失败，别把 400 当熔断触发条件 - 示例片段：
cb := gobreaker.NewCircuitBreaker(gobreaker.Settings{ Name: "payment-api", MaxRequests: 10, Timeout: 60 * time.Second, ReadyToTrip: func(counts gobreaker.Counts) bool { return counts.TotalFailures > 3 && float64(counts.TotalFailures)/float64(counts.Requests) > 0.5 }, }) <p>iris.Use(func(ctx iris.Context) { _, err := cb.Execute(func() (interface{}, error) { ctx.Next() // 执行下游 handler return nil, nil }) if err != nil { if errors.Is(err, gobreaker.ErrOpenState) { ctx.StatusCode(503) ctx.WriteString("service unavailable (circuit open)") return } ctx.StatusCode(500) ctx.WriteString("internal error") return } })
降级逻辑怎么嵌进中间件里
熔断器打开后，你不能只返回 503；真实场景需要 fallback 值，比如缓存结果、兜底 JSON、空对象。这必须在中间件里显式写分支逻辑，而不是依赖框架自动注入。
- 不要在
cb.Execute外部做降级判断——那样会绕过熔断器的状态管理 - 降级数据建议从 Redis 或本地内存（如
fastcache）读取，避免降级时又去查 DB 导致二次雪崩 - 如果降级内容是 JSON，记得设置
Content-Type: application/json，否则前端可能解析失败 - 关键细节：降级响应体应和正常接口结构一致，字段名、嵌套层级、空值表示方式（如
nullvs"N/A"）必须对齐，否则前端报错
并发高时容易踩的坑
Iris 的中间件是 per-request 执行的，但 gobreaker 实例是全局共享的。高并发下若多个路由共用同一个 CircuitBreaker，会导致状态混乱——比如订单接口失败抬高了支付接口的失败率。
- 每个业务接口（甚至每个下游服务地址）都该配独立的
gobreaker.CircuitBreaker实例 - 别用 map[string]*gobreaker.CircuitBreaker 动态生成后不加锁，goroutine 并发写 map 会 panic
- 初始化阶段就预建好所有 CB 实例，用 sync.Once 或依赖注入容器管理生命周期
- Redis 降级缓存 key 要加命名空间前缀，例如
degraded:payment:order:123，防止和正常缓存 key 冲突
真正难的不是写通熔断逻辑，而是让 fallback 数据在格式、时效、来源上都经得起线上流量冲击——这往往需要配合监控告警、人工开关、缓存预热一起落地。
