Spring Cloud Gateway启动报错：找不到Hystrix GatewayFilterFactory

问题根源 #

Spring Cloud 2021.0.x（代号Jubilee）版本起，Spring Cloud Gateway已彻底移除了对Hystrix的内置GatewayFilterFactory支持，官方不再维护Hystrix与Gateway的集成，转而推荐使用Resilience4j作为熔断降级的替代方案。你配置的Hystrix过滤器在该版本中已不存在，因此启动时会抛出Unable to find GatewayFilterFactory with name Hystrix错误。

解决步骤 #

1. 清理冗余依赖
   移除spring-cloud-starter-netflix-hystrix依赖，该依赖在当前Gateway版本中已无作用，且可能引发不必要的版本冲突。保留spring-cloud-starter-circuitbreaker-reactor-resilience4j即可。

2. 替换路由过滤器配置
   将原配置中的Hystrix过滤器替换为Resilience4j对应的CircuitBreaker过滤器：
   原错误配置示例：

   spring:
     cloud:
       gateway:
         routes:
           - id: demo_route
             uri: http://your-target-service
             filters:
               - name: Hystrix
                 args:
                   name: demoFallback
                   fallbackUri: forward:/demo-fallback
   

   修改后的正确配置：

   spring:
     cloud:
       gateway:
         routes:
           - id: demo_route
             uri: http://your-target-service
             filters:
               - name: CircuitBreaker
                 args:
                   name: demoFallback
                   fallbackUri: forward:/demo-fallback
   

3. 配置Resilience4j熔断规则
   在配置文件中添加Resilience4j的具体熔断策略，示例如下：

   resilience4j:
     circuitbreaker:
       instances:
         demoFallback:
           failure-rate-threshold: 50  # 失败率阈值达到50%时触发熔断
           wait-duration-in-open-state: 10s  # 熔断后10秒尝试恢复
           sliding-window-type: COUNT_BASED  # 基于请求数统计
           sliding-window-size: 10  # 统计窗口内的请求数
           minimum-number-of-calls: 5  # 触发统计的最小请求数
   

4. 验证版本兼容性
   确保Spring Boot版本与Spring Cloud 2021.0.8匹配（对应Spring Boot 2.6.x系列），避免因版本不匹配导致的隐性问题。

特殊情况说明 #

如果业务必须依赖Hystrix而非Resilience4j，唯一的解决方式是降级Spring Cloud版本到2020.0.x（Ilford）或更早，这些版本仍保留Hystrix GatewayFilterFactory的支持，但官方已停止维护，存在安全风险，不推荐使用。

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