Spring Boot 1.5.10配置Hystrix/Feign仅响应HTTP 429状态码

针对你的Spring Boot 1.5.10应用需求，我会一步步拆解实现方案，确保只在后端返回429状态码时触发Hystrix熔断，且熔断窗口设置为1小时，期间调用降级方法：

1. 基础依赖与启用配置 #

首先确保你的pom.xml中引入适配的依赖（对应Spring Cloud Edgware版本，完美匹配Boot 1.5.10）：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-feign</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-hystrix</artifactId>
</dependency>

然后在启动类上开启Feign和Hystrix的核心功能：

@SpringBootApplication
@EnableFeignClients
@EnableCircuitBreaker
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

2. 开启Feign的Hystrix支持 #

在application.yml（或application.properties）中打开Feign与Hystrix的集成开关：

feign:
  hystrix:
    enabled: true

3. 自定义Feign错误解码器，精准识别HTTP 429 #

我们需要自定义ErrorDecoder，让Feign在收到429状态码时抛出特定异常，这样Hystrix会把这个请求标记为失败，进而触发熔断逻辑：

@Component
public class Custom429ErrorDecoder implements ErrorDecoder {

    private final ErrorDecoder defaultErrorDecoder = new Default();

    @Override
    public Exception decode(String methodKey, Response response) {
        if (response.status() == 429) {
            // 抛出自定义异常，专门用于触发Hystrix熔断
            return new TooManyRequestsException("后端返回429请求过多，触发熔断保护");
        }
        // 其他状态码交给默认解码器处理
        return defaultErrorDecoder.decode(methodKey, response);
    }

    // 自定义异常类，用于标记429场景
    public static class TooManyRequestsException extends RuntimeException {
        public TooManyRequestsException(String message) {
            super(message);
        }
    }
}

4. 定义Feign客户端与降级实现 #

创建Feign接口，指定降级类，并通过@HystrixCommand配置针对429的熔断参数：

@FeignClient(name = "your-backend-service", fallback = YourBackendFallback.class)
public interface YourBackendClient {

    @GetMapping("/api/your-target-endpoint")
    @HystrixCommand(
            commandProperties = {
                    // 熔断休眠窗口设置为1小时（3600000毫秒）
                    @HystrixProperty(name = "circuitBreaker.sleepWindowInMilliseconds", value = "3600000"),
                    // 触发熔断的最小请求数，设为1意味着只要出现一次429就触发熔断
                    @HystrixProperty(name = "circuitBreaker.requestVolumeThreshold", value = "1"),
                    // 错误百分比阈值设为100，只要有429失败就触发熔断
                    @HystrixProperty(name = "circuitBreaker.errorThresholdPercentage", value = "100")
            }
    )
    String callBackendEndpoint();
}

// 降级逻辑实现类
@Component
public class YourBackendFallback implements YourBackendClient {

    @Override
    public String callBackendEndpoint() {
        // 这里写你的降级逻辑，比如返回友好提示或默认数据
        return "请求过于频繁，请稍后再试（系统会在1小时后自动重试）";
    }
}

5. 关键配置说明 #

• circuitBreaker.sleepWindowInMilliseconds：设置熔断后的休眠时长，这里设为3600000毫秒（1小时），期间所有请求都会直接走降级方法，不会尝试访问真实后端。
• circuitBreaker.requestVolumeThreshold：触发熔断的最小请求数，设为1确保只要收到一次429就立刻触发熔断。
• circuitBreaker.errorThresholdPercentage：错误百分比阈值，设为100表示只要出现我们自定义的429异常，就触发熔断。

注意事项 #

• 如果不同接口需要不同的熔断策略，可以为每个Feign方法单独配置@HystrixCommand参数。
• 确保自定义的ErrorDecoder被Spring容器扫描到，否则Feign会用默认解码器，无法识别429触发熔断。
• 虽然Spring Boot 1.5.x对应的Edgware版本已停止维护，但上述配置在该版本环境下是完全可行的。

内容的提问来源于stack exchange，提问作者user3105453