Spring Cloud OpenFeign 默认不启用降级，需显式配置 Fallback 或 FallbackFactory；推荐使用 Resilience4J（2020+ 默认移除 Hystrix），通过 fallback/fallbackFactory 实现降级逻辑，并注意构造器、签名匹配及 errorDecoder 配置。
Spring Cloud OpenFeign 默认不启用降级，必须显式配置 Fallback 或 FallbackFactory 才能捕获远程调用失败（如超时、连接拒绝、服务不可用等），并返回兜底响应。
开启 Feign 的降级支持
在 application.yml 中启用 Feign 的 Hystrix（旧版）或 Resilience4J（推荐新版）降级能力。Spring Cloud 2020+ 默认移除了 Hystrix，建议使用 Resilience4J：
- 添加依赖：
spring-cloud-starter-circuitbreaker-resilience4j - 确保
feign.circuitbreaker.enabled=true（Spring Cloud 2020.0.1+ 默认开启） - 若用旧版（Hystrix），需额外引入
spring-cloud-starter-netflix-hystrix并设置feign.hystrix.enabled=true
定义 Fallback 类实现接口
创建一个类实现你的 @FeignClient 接口，并提供所有方法的降级逻辑：
class UserClientFallback implements UserClient {
@Override
public UserDTO getUserById(Long id) {
return new UserDTO().setId(-1L).setName("fallback_user");
}
@Override
public List<UserDTO> listUsers() {
return Collections.emptyList();
}
}
然后在 FeignClient 注解中指定：
立即学习“Java免费学习笔记（深入）”；
@FeignClient(name = "user-service", fallback = UserClientFallback.class)
public interface UserClient { ... }
注意：Fallback 类必须有无参构造器，且不能是内部类（否则可能实例化失败）。
更灵活的方式：使用 FallbackFactory
当需要获取原始异常信息（比如记录日志、按错误类型差异化降级），推荐用 FallbackFactory：
class UserClientFallbackFactory implements FallbackFactory<UserClient> {
@Override
public UserClient create(Throwable cause) {
return new UserClient() {
@Override
public UserDTO getUserById(Long id) {
log.warn("getUserById fallback, cause: {}", cause.getMessage());
return null;
}
// 其他方法...
};
}
}
绑定方式：
@FeignClient(name = "user-service", fallbackFactory = UserClientFallbackFactory.class)
public interface UserClient { ... }
验证降级是否生效
常见失效原因：
- 未启用 circuit breaker（检查配置项是否生效）
- Fallback 类未被 Spring 管理（不要加
@Component，Feign 会自动实例化） - 方法签名不一致（参数类型、顺序、返回值必须完全匹配）
- 远程服务返回 4xx/5xx HTTP 状态码但未配置
errorDecoder，默认不会触发 fallback（Feign 默认只对网络异常和超时降级；业务异常需手动 throw RuntimeException）
如需对特定 HTTP 状态码也触发降级，可自定义 ErrorDecoder 抛出运行时异常。
