Spring Cloud Gateway自定义过滤器无法应用到指定路由问题

问题描述 #

• 耗时两天尝试通过继承AbstractGatewayFilterFactory实现网关自定义过滤器，严格遵循Spring官方文档步骤开发，但配置spring.cloud.gateway.default-filters=AuthFilter时，过滤器会对所有路由生效，而实际需求是仅将其应用到指定的特定路由。期间查阅了大量同类问题，但均未找到可行方案。

解决方案 #

已解决该问题，同类问题可参考以下操作步骤：

1. 修正过滤器类命名：自定义过滤器类必须以GatewayFilterFactory作为后缀，例如将原AuthFilter类重命名为AuthGatewayFilterFactory。Spring Cloud Gateway会自动识别符合该命名规范的类作为可配置的路由过滤器，配置时只需使用前缀部分（即AuthFilter）即可。
2. 移除全局过滤器配置：删除application.properties中的spring.cloud.gateway.default-filters=AuthFilter配置，避免过滤器全局生效。
3. 为特定路由配置过滤器：在目标路由的filters属性中指定该过滤器，示例配置如下（以YAML格式为例，Properties格式可对应转换）：

spring:
  cloud:
    gateway:
      routes:
        - id: target_route
          uri: http://your-target-service-url
          predicates:
            - Path=/api/your-specific-path/**
          filters:
            - AuthFilter

4. 检查配置参数（若有）：如果你的过滤器需要接收自定义配置参数，需确保在过滤器类中正确定义对应的配置类，并通过@ConfigurationProperties或构造方法完成参数注入，避免因参数解析异常导致过滤器未生效。

内容的提问来源于stack exchange，提问作者Farfetch'd