Go 高可用策略库-Resilience

在微服务和高并发场景中，服务的可用性、稳定性和健壮性至关重要。Go 语言虽然轻量高效，但在容错策略方面缺少一站式解决方案。为此，我开源了 Resilience ------ 一个 Go 原生实现的高可用策略库，支持重试、熔断、隔离、超时和回退等策略组合。

本文将带你全面了解这个库的设计理念、核心实现和使用方式。

---

一、项目背景

在实际生产中，常见的容错场景包括：

• 服务偶发失败：网络抖动或依赖服务短暂不可用
• 请求超时：希望在一定时间内完成操作
• 并发控制：限制某些操作的最大并发数，防止雪崩
• 熔断：连续失败时快速失败，保护后端服务
• 回退：操作失败时提供默认返回或备用方案

为了应对这些场景，我实现了 Resilience 库，它可以在 Go 项目中轻松组合各种策略，保证服务的稳定性和可用性。

---

二、核心策略

1. Retry（重试）

retry := NewRetry(3).
    Handle(func(err error) bool { return err != nil }).
    WithBackoff(ExponentialBackoff{Base: 100*time.Millisecond})

• 支持最大重试次数或无限重试
• 可自定义重试条件和回调
• 支持多种退避策略（固定、指数、随机）

---

2. Timeout（超时）

timeout := NewTimeout(50 * time.Millisecond)

• 支持乐观模式（基于 context 取消）
• 支持悲观模式（无视函数行为强制超时）
• 可设置超时回调

---

3. Fallback（回退）

fallback := NewFallback(func(ctx context.Context) error {
    // 默认返回或备用逻辑
    return nil
})

• 支持自定义错误条件
• 支持回调函数
• 可与其他策略组合使用

---

4. Bulkhead（隔离/并发控制）

bulkhead := NewBulkhead(5, 10).OnRejected(func(ctx context.Context) {
    fmt.Println("请求被拒绝，已达到最大并发")
})

• 限制最大并发执行数
• 支持排队队列
• 支持拒绝回调

---

5. CircuitBreaker（熔断器）

cb := NewCircuitBreaker(3, 50*time.Millisecond).
    OnBreak(func(err error, dur time.Duration){ fmt.Println("熔断触发") }).
    OnReset(func(){ fmt.Println("熔断重置") }).
    OnHalfOpen(func(){ fmt.Println("HalfOpen 状态") })

• 支持失败次数阈值
• 支持开闭半开状态切换
• 支持回调函数

---

6. WrapPolicy（策略组合）

wrapped := Wrap(retry, timeout, fallback, bulkhead, cb)

err := wrapped.Execute(context.Background(), func(ctx context.Context) error {
    return callRemoteService()
})

• 支持多策略组合
• 执行顺序从内向外
• 可实现复杂容错链路

---

三、性能与基准测试

核心策略性能如下：

策略	ns/op	allocs/op
Retry (单次)	7 ns	0
Fallback	5 ns	0
Bulkhead 并发	12 μs	0
CircuitBreaker 并发	168 ns	0

• 零内存分配，极低开销
• 并发安全，适合高 QPS 场景

完整基准测试已集成在项目仓库，可直接使用：

go test -bench=. -benchmem ./resilience

---

四、使用场景

• 微服务调用保护：结合 Retry + Timeout + CircuitBreaker
• 高并发请求隔离：使用 Bulkhead 控制服务压力
• 降级策略：Fallback 提供默认值或备用逻辑
• 组合策略管道：WrapPolicy 实现复杂策略组合

示例：

wrapped := Wrap(
    NewRetry(3),
    NewTimeout(100*time.Millisecond),
    NewFallback(func(ctx context.Context) error { return nil }),
    NewBulkhead(10, 5),
    NewCircuitBreaker(5, 1*time.Second),
)

---

五、开源仓库

• GitHub: github.com/HongFeng-Ch...
• 支持 GoDoc 文档自动生成

---

六、总结

Resilience 是一个 工业级 Go 高可用策略库：

• 支持 Retry、Timeout、Fallback、Bulkhead、CircuitBreaker 等策略
• 高性能、零内存分配
• 并发安全
• 支持策略组合，易于扩展

未来计划：

• 增加 OpenTelemetry 指标支持
• 支持更多 Backoff 策略
• 提供策略链路可视化工具

💡 如果你的 Go 项目需要微服务容错、熔断、降级或高并发控制，Resilience 可以直接提升系统稳定性。

---