Spring Cloud Gateway自定义过滤器IntelliJ启动失败，Eclipse/命令行正常

以下是针对该问题的排查和解决步骤：

1. 重新编译项目 #

IntelliJ的增量编译偶尔会出现遗漏，导致自定义过滤器类未被正确编译到运行环境中：

• 执行菜单栏 Build → Rebuild Project，完成后重启应用。
• 也可以先在终端运行 mvn clean compile 清理并编译，再回到IntelliJ启动服务。

2. 验证组件扫描配置 #

确保Spring能扫描到你的自定义过滤器类：

• 过滤器类必须添加 @Component 注解，让Spring将其纳入上下文管理。
• 检查启动类的 @SpringBootApplication 注解，确认 scanBasePackages 属性包含过滤器所在的包路径。示例：

  @SpringBootApplication(scanBasePackages = {"com.your.gateway", "com.your.filters"})
  public class GatewayApplication {
      public static void main(String[] args) {
          SpringApplication.run(GatewayApplication.class, args);
      }
  }
  

3. 清理IntelliJ缓存 #

IDE缓存可能导致加载旧的编译文件或配置：

• 点击 File → Invalidate Caches...，选择 Invalidate and Restart，等待IDE重启后重新启动应用。

4. 检查Maven配置一致性 #

确保IntelliJ使用的Maven配置与你本地构建时一致：

• 打开 File → Settings → Build, Execution, Deployment → Build Tools → Maven，确认 Maven home path 为本地使用的Maven版本，User settings file 指向正确的settings.xml。
• 右键项目 → Maven → Reload Project，刷新依赖和项目配置。

5. 确认过滤器命名与配置匹配 #

虽然其他环境正常，但仍需验证配置中的过滤器名称与Spring Bean名称一致：

• 如果你的过滤器类名为 AuthenticationFilter，配置文件中应使用 AuthenticationFilter 作为过滤器名称（Spring默认Bean名称为类名首字母小写，但Spring Cloud Gateway支持按类名全匹配查找）。
• 若你通过 @Component("CustomName") 指定了Bean名称，配置中需使用对应的CustomName。

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