Quarkus无法识别Maven依赖中使用@WebFilter注解的Servlet过滤器

问题根因 #

Quarkus 构建阶段默认仅扫描当前应用项目下的类路径注解，不会自动扫描第三方Maven依赖中的@WebFilter、@WebServlet这类Servlet规范注解，因此你本地项目内定义的过滤器可以正常生效，依赖中的过滤器无法被识别。

可行解决方案 #

以下三种方案任选其一即可生效：

方案1：指定依赖过滤器的扫描包（最简单） #

在应用的application.properties中添加配置，指定第三方过滤器所在的包路径，Quarkus会自动扫描对应包下的Servlet注解：

# 替换为你依赖中过滤器所在的实际包名，多个包用逗号分隔
quarkus.servlet.filter.scan-packages=com.xxx.xxx.filter,com.xxx.xxx.xxx

方案2：手动注册单个过滤器（更精准） #

如果只需要加载依赖中的少量过滤器，不需要全量扫描包，可以直接在配置中显式注册过滤器，避免不必要的类扫描开销：

# myfilter可替换为自定义的过滤器名称
quarkus.servlet.filters.myfilter.class=com.xxx.xxx.YourFilterClassName
# 配置过滤器拦截路径，多个路径用逗号分隔
quarkus.servlet.filters.myfilter.url-patterns=/*
# 配置过滤器执行顺序，数值越小优先级越高
quarkus.servlet.filters.myfilter.order=1

方案3：给第三方依赖添加Jandex索引（如果你可维护该依赖） #

如果这个包含过滤器的Maven依赖是你团队内部维护的，可以在依赖的pom.xml中添加Jandex打包插件，构建时生成注解索引，Quarkus会自动识别索引中的@WebFilter注解，不需要在应用侧额外配置：

<build>
  <plugins>
    <plugin>
      <groupId>org.jboss.jandex</groupId>
      <artifactId>jandex-maven-plugin</artifactId>
      <version>最新稳定版本号</version>
      <executions>
        <execution>
          <id>make-index</id>
          <goals>
            <goal>jandex</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

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