增加熔断策略

This commit is contained in:
2026-01-01 10:48:47 +08:00
parent 60902a9839
commit 456bee2cae

View File

@@ -18,24 +18,25 @@ import (
type CircuitBreakerState string type CircuitBreakerState string
const ( const (
StateClosed CircuitBreakerState = "closed" // 关闭:正常状态 StateClosed CircuitBreakerState = "closed" // 关闭:正常状态
StateOpen CircuitBreakerState = "open" // 开启:熔断状态 StateOpen CircuitBreakerState = "open" // 开启:熔断状态
StateHalfOpen CircuitBreakerState = "half-open" // 半开:尝试恢复状态
) )
// CircuitBreakerConfig 熔断器配置 // CircuitBreakerConfig 熔断器配置
type CircuitBreakerConfig struct { type CircuitBreakerConfig struct {
Enabled bool // 是否启用熔断器 Enabled bool // 是否启用熔断器
MaxFailures int // 连续失败次数 MaxFailures int // 连续失败次数
Timeout string // 熔断超时时间 Timeout string // 熔断超时时间
SuccessStatusCodes []int // 视为成功的HTTP状态码 TimeoutParsed time.Duration // 缓存的超时时间(性能优化)
SlowRequestThreshold string // 慢请求阈值 SuccessStatusCodes []int // 视为成功的HTTP状态码
EnableSlidingWindow bool // 是否启用滑动窗口 SlowRequestThreshold string // 慢请求阈值
FailureRateThreshold float64 // 失败率阈值 SlowRequestThresholdParsed time.Duration // 缓存的慢请求阈值(性能优化)
EnableFallback bool // 是否启用降级 EnableSlidingWindow bool // 是否启用滑动窗口
FallbackMessage string // 降级提示消息 FailureRateThreshold float64 // 失败率阈值
RequestTimeout int // 请求超时时间(毫秒) EnableFallback bool // 是否启用降级
DistributedTTL int // 分布式熔断状态TTL FallbackMessage string // 降级提示消息
RequestTimeout int // 请求超时时间(毫秒)
DistributedTTL int // 分布式熔断状态TTL
} }
// CircuitBreakerMetrics 熔断器指标 // CircuitBreakerMetrics 熔断器指标
@@ -52,8 +53,6 @@ type CircuitBreakerInfo struct {
ResourceName string `json:"resourceName"` // 资源名称 ResourceName string `json:"resourceName"` // 资源名称
State CircuitBreakerState `json:"state"` // 当前状态 State CircuitBreakerState `json:"state"` // 当前状态
Config *CircuitBreakerConfig `json:"config"` // 配置信息 Config *CircuitBreakerConfig `json:"config"` // 配置信息
FailCount int64 `json:"failCount"` // 失败次数
TotalCount int64 `json:"totalCount"` // 总请求数
LastOpenTime time.Time `json:"lastOpenTime"` // 上次熔断时间 LastOpenTime time.Time `json:"lastOpenTime"` // 上次熔断时间
NextRetryTime time.Time `json:"nextRetryTime"` // 下次重试时间 NextRetryTime time.Time `json:"nextRetryTime"` // 下次重试时间
Metrics *CircuitBreakerMetrics `json:"metrics"` // 指标统计 Metrics *CircuitBreakerMetrics `json:"metrics"` // 指标统计
@@ -65,10 +64,12 @@ var (
circuitBreakers sync.Map circuitBreakers sync.Map
// circuitBreakerConfigs 熔断器配置缓存 // circuitBreakerConfigs 熔断器配置缓存
circuitBreakerConfigs sync.Map circuitBreakerConfigs sync.Map
// distributedSyncLock 分布式同步锁 // distributedSyncLocks 分布式同步锁(按服务名分片)
distributedSyncLock sync.Mutex distributedSyncLocks sync.Map
// stateChangeListeners 状态变化监听器 // stateChangeListeners 状态变化监听器
stateChangeListeners sync.Map stateChangeListeners sync.Map
// stateChangeListenersRegistered 默认监听器是否已注册
stateChangeListenersRegistered sync.Map
) )
// InitCircuitBreaker 初始化Sentinel熔断器 // InitCircuitBreaker 初始化Sentinel熔断器
@@ -78,7 +79,7 @@ func InitCircuitBreaker() error {
// 初始化Sentinel // 初始化Sentinel
err := api.InitDefault() err := api.InitDefault()
if err != nil { if err != nil {
return fmt.Errorf("Sentinel初始化失败: %v", err) return fmt.Errorf("sentinel初始化失败: %v", err)
} }
// 注册熔断器状态变化监听器 // 注册熔断器状态变化监听器
@@ -90,12 +91,7 @@ func InitCircuitBreaker() error {
services := g.Cfg().MustGet(ctx, "circuitBreaker").Map() services := g.Cfg().MustGet(ctx, "circuitBreaker").Map()
// 过滤掉非服务配置的key // 过滤掉非服务配置的key
serviceNames := make([]string, 0) serviceNames := filterServiceNames(services)
for key := range services {
if key != "services" && key != "enableDistributed" && key != "requestTimeout" && key != "distributedTTL" {
serviceNames = append(serviceNames, key)
}
}
if len(serviceNames) == 0 { if len(serviceNames) == 0 {
g.Log().Infof(ctx, "未配置任何服务熔断器") g.Log().Infof(ctx, "未配置任何服务熔断器")
@@ -167,18 +163,33 @@ func loadServiceCircuitBreakerConfig(serviceName string) *CircuitBreakerConfig {
successCodes := g.Cfg().MustGet(ctx, key+".successStatusCodes", "200,201,204").String() successCodes := g.Cfg().MustGet(ctx, key+".successStatusCodes", "200,201,204").String()
statusCodes := parseStatusCodes(successCodes) statusCodes := parseStatusCodes(successCodes)
// 解析时间(缓存结果,性能优化)
timeoutParsed, err := time.ParseDuration(timeout)
if err != nil {
timeoutParsed = 60 * time.Second
g.Log().Warningf(ctx, "服务 %s 的 timeout 解析失败,使用默认值: %v", serviceName, err)
}
slowRequestThresholdParsed, err := time.ParseDuration(slowRequestThreshold)
if err != nil {
slowRequestThresholdParsed = 3 * time.Second
g.Log().Warningf(ctx, "服务 %s 的 slowRequestThreshold 解析失败,使用默认值: %v", serviceName, err)
}
return &CircuitBreakerConfig{ return &CircuitBreakerConfig{
Enabled: enabled, Enabled: enabled,
MaxFailures: maxFailures, MaxFailures: maxFailures,
Timeout: timeout, Timeout: timeout,
SuccessStatusCodes: statusCodes, TimeoutParsed: timeoutParsed,
SlowRequestThreshold: slowRequestThreshold, SuccessStatusCodes: statusCodes,
EnableSlidingWindow: enableSlidingWindow, SlowRequestThreshold: slowRequestThreshold,
FailureRateThreshold: failureRateThreshold, SlowRequestThresholdParsed: slowRequestThresholdParsed,
EnableFallback: enableFallback, EnableSlidingWindow: enableSlidingWindow,
FallbackMessage: fallbackMessage, FailureRateThreshold: failureRateThreshold,
RequestTimeout: requestTimeout, EnableFallback: enableFallback,
DistributedTTL: distributedTTL, FallbackMessage: fallbackMessage,
RequestTimeout: requestTimeout,
DistributedTTL: distributedTTL,
} }
} }
@@ -195,6 +206,24 @@ func parseStatusCodes(str string) []int {
return codes return codes
} }
// filterServiceNames 过滤服务名排除非服务配置的key
func filterServiceNames(services map[string]interface{}) []string {
excludeKeys := map[string]bool{
"services": true,
"enableDistributed": true,
"requestTimeout": true,
"distributedTTL": true,
}
serviceNames := make([]string, 0, len(services))
for key := range services {
if !excludeKeys[key] {
serviceNames = append(serviceNames, key)
}
}
return serviceNames
}
// initServiceCircuitBreaker 初始化服务熔断器 // initServiceCircuitBreaker 初始化服务熔断器
func initServiceCircuitBreaker(serviceName string, config *CircuitBreakerConfig) error { func initServiceCircuitBreaker(serviceName string, config *CircuitBreakerConfig) error {
// 验证配置参数 // 验证配置参数
@@ -202,15 +231,9 @@ func initServiceCircuitBreaker(serviceName string, config *CircuitBreakerConfig)
return fmt.Errorf("配置验证失败: %v", err) return fmt.Errorf("配置验证失败: %v", err)
} }
timeout, err := time.ParseDuration(config.Timeout) // 使用缓存的时间值(性能优化)
if err != nil { timeout := config.TimeoutParsed
return fmt.Errorf("解析超时时间失败: %v", err) slowRequestThreshold := config.SlowRequestThresholdParsed
}
slowRequestThreshold, err := time.ParseDuration(config.SlowRequestThreshold)
if err != nil {
return fmt.Errorf("解析慢请求阈值失败: %v", err)
}
resourceName := fmt.Sprintf("service:%s", serviceName) resourceName := fmt.Sprintf("service:%s", serviceName)
@@ -243,8 +266,11 @@ func initServiceCircuitBreaker(serviceName string, config *CircuitBreakerConfig)
} }
} }
// 加载规则到Sentinel // 先清理旧规则(健壮性改进)
_, err = circuitbreaker.LoadRules(rule) _, _ = circuitbreaker.LoadRulesOfResource(resourceName, []*circuitbreaker.Rule{})
// 加载新规则到Sentinel
_, err := circuitbreaker.LoadRules(rule)
if err != nil { if err != nil {
return fmt.Errorf("加载熔断规则失败: %v", err) return fmt.Errorf("加载熔断规则失败: %v", err)
} }
@@ -340,9 +366,8 @@ func CircuitBreakerMiddleware(r *ghttp.Request) {
oldState := cbInfo.State oldState := cbInfo.State
cbInfo.State = StateOpen cbInfo.State = StateOpen
cbInfo.LastOpenTime = time.Now() cbInfo.LastOpenTime = time.Now()
if timeout, err := time.ParseDuration(config.Timeout); err == nil { // 使用缓存的时间值(性能优化)
cbInfo.NextRetryTime = time.Now().Add(timeout) cbInfo.NextRetryTime = time.Now().Add(config.TimeoutParsed)
}
cbInfo.mu.Unlock() cbInfo.mu.Unlock()
// 通知状态变化(如果状态改变) // 通知状态变化(如果状态改变)
@@ -395,8 +420,6 @@ func sendFallbackResponse(r *ghttp.Request, serviceName string, config *CircuitB
} else { } else {
// 根据原因返回不同的状态码和消息 // 根据原因返回不同的状态码和消息
switch reason { switch reason {
case "timeout":
r.Response.WriteStatusExit(504, fmt.Sprintf("服务 '%s' 响应超时", serviceName))
case "blocked": case "blocked":
r.Response.WriteStatusExit(503, fmt.Sprintf("服务 '%s' 熔断保护中,请稍后再试", serviceName)) r.Response.WriteStatusExit(503, fmt.Sprintf("服务 '%s' 熔断保护中,请稍后再试", serviceName))
case "distributed": case "distributed":
@@ -451,10 +474,19 @@ func isCircuitBreakerOpenInDistributed(ctx context.Context, resourceName string)
return state == "open" return state == "open"
} }
// getDistributedLock 获取分布式锁(按服务名分片)
func getDistributedLock(serviceName string) *sync.Mutex {
lock, _ := distributedSyncLocks.LoadOrStore(serviceName, &sync.Mutex{})
return lock.(*sync.Mutex)
}
// syncCircuitBreakerStateToDistributed 同步熔断器状态到分布式存储 // syncCircuitBreakerStateToDistributed 同步熔断器状态到分布式存储
func syncCircuitBreakerStateToDistributed(ctx context.Context, resourceName, state string, ttl int) { func syncCircuitBreakerStateToDistributed(ctx context.Context, resourceName, state string, ttl int) {
distributedSyncLock.Lock() // 提取服务名用于锁分片
defer distributedSyncLock.Unlock() serviceName := strings.TrimPrefix(resourceName, "service:")
lock := getDistributedLock(serviceName)
lock.Lock()
defer lock.Unlock()
key := fmt.Sprintf("circuit_breaker:%s:state", resourceName) key := fmt.Sprintf("circuit_breaker:%s:state", resourceName)
@@ -481,12 +513,30 @@ func validateCircuitBreakerConfig(config *CircuitBreakerConfig) error {
if len(config.SuccessStatusCodes) == 0 { if len(config.SuccessStatusCodes) == 0 {
return fmt.Errorf("successStatusCodes不能为空") return fmt.Errorf("successStatusCodes不能为空")
} }
if config.RequestTimeout < 0 || config.RequestTimeout > 300000 {
return fmt.Errorf("requestTimeout必须在0-300000毫秒之间")
}
if config.DistributedTTL < 0 || config.DistributedTTL > 3600 {
return fmt.Errorf("distributedTTL必须在0-3600秒之间")
}
// 验证时间字符串格式(如果缓存为空,说明解析失败)
if config.TimeoutParsed == 0 {
return fmt.Errorf("timeout格式错误应为有效的时间字符串如30s, 1m")
}
if config.SlowRequestThresholdParsed == 0 {
return fmt.Errorf("slowRequestThreshold格式错误应为有效的时间字符串如3s, 1m")
}
return nil return nil
} }
// registerStateChangeListeners 注册状态变化监听器 // registerStateChangeListeners 注册状态变化监听器
func registerStateChangeListeners() { func registerStateChangeListeners() {
// 示例:注册默认监听器 // 检查是否已注册,防止重复注册(健壮性改进)
if _, exists := stateChangeListenersRegistered.LoadOrStore("default", true); exists {
return
}
// 注册默认监听器
RegisterStateChangeListener("default", func(serviceName string, fromState, toState CircuitBreakerState) { RegisterStateChangeListener("default", func(serviceName string, fromState, toState CircuitBreakerState) {
g.Log().Infof(context.Background(), "熔断器状态变化: service=%s, %s -> %s", g.Log().Infof(context.Background(), "熔断器状态变化: service=%s, %s -> %s",
serviceName, fromState, toState) serviceName, fromState, toState)
@@ -534,6 +584,7 @@ func CircuitBreakerHealthCheckHandler(r *ghttp.Request) {
openServices++ openServices++
} }
// 从Metrics中读取数据修复数据准确性问题
status[serviceName] = map[string]interface{}{ status[serviceName] = map[string]interface{}{
"resource": cbInfo.ResourceName, "resource": cbInfo.ResourceName,
"state": string(cbInfo.State), "state": string(cbInfo.State),
@@ -646,12 +697,7 @@ func CircuitBreakerReloadHandler(r *ghttp.Request) {
services := g.Cfg().MustGet(r.GetCtx(), "circuitBreaker").Map() services := g.Cfg().MustGet(r.GetCtx(), "circuitBreaker").Map()
// 过滤出服务名 // 过滤出服务名
serviceNames := make([]string, 0) serviceNames := filterServiceNames(services)
for key := range services {
if key != "services" && key != "enableDistributed" && key != "requestTimeout" && key != "distributedTTL" {
serviceNames = append(serviceNames, key)
}
}
successCount := 0 successCount := 0
failCount := 0 failCount := 0