如何消除maven-jetty-plugin jetty:run的重复扫描警告？

问题现象 #

在myApp-server模块中使用maven-jetty-plugin v11.0.19，执行jetty:run时会输出约80条重复类扫描警告，示例如下：

[WARNING] jakarta.servlet.AsyncEvent scanned from multiple locations:
jar:file:///C:/Users/tim_m/.m2/repository/org/eclipse/jetty/toolchain/jetty-jakarta-servlet-api/5.0.2/jetty-jakarta-servlet-api-5.0.2.jar!
jar:file:///C:/Users/tim_m/.m2/repository/org/eclipse/jetty/toolchain/jetty-jakarta-servlet-api/5.0.2/jetty-jakarta-servlet-api-5.0.2.jar!

依赖关系说明：

• jetty-server是myApp-jettyMain模块（生产环境嵌入式服务器）的直接依赖
• jetty-jakarta-servlet-api由jetty-server间接引入
• myApp-jettyMain:jar作为依赖被myApp-server引入

尽管警告中显示的扫描路径完全一致，但这些警告不仅影响日志可读性，还会拖慢Jetty启动速度。

排查线索 #

开启调试模式执行jetty:run后，发现jetty-jakarta-servlet-api被重复加入到容器扫描路径中：

[DEBUG] Container paths selected:[file:///C:/Users/tim_m/.m2/repository/org/eclipse/jetty/toolchain/jetty-jakarta-servlet-api/5.0.2/jetty-jakarta-servlet-api-5.0.2.jar, file:///C:/Users/tim_m/.m2/repository/jakarta/servlet/jsp/jstl/jakarta.servlet.jsp.jstl-api/2.0.0/jakarta.servlet.jsp.jstl-api-2.0.0.jar, file:///C:/Users/tim_m/.m2/repository/org/glassfish/web/jakarta.servlet.jsp.jstl/2.0.0/jakarta.servlet.jsp.jstl-2.0.0.jar]

解决方案 #

1. 排除插件中的重复API依赖 #

在myApp-server模块的maven-jetty-plugin配置中，显式排除jetty-jakarta-servlet-api依赖，避免插件与myApp-jettyMain带来的重复引入：

<plugin>
    <groupId>org.eclipse.jetty</groupId>
    <artifactId>jetty-maven-plugin</artifactId>
    <version>11.0.19</version>
    <dependencies>
        <dependency>
            <groupId>org.eclipse.jetty</groupId>
            <artifactId>jetty-server</artifactId>
            <version>11.0.19</version>
            <exclusions>
                <exclusion>
                    <groupId>org.eclipse.jetty.toolchain</groupId>
                    <artifactId>jetty-jakarta-servlet-api</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>
</plugin>

2. 手动指定容器扫描路径 #

在jetty插件配置中，通过containerIncludeJarPattern定义精确的扫描规则，只包含必要的JAR文件，避免重复扫描：

<plugin>
    <groupId>org.eclipse.jetty</groupId>
    <artifactId>jetty-maven-plugin</artifactId>
    <version>11.0.19</version>
    <configuration>
        <containerIncludeJarPattern>.*/jetty-jakarta-servlet-api-[^/]*\.jar$|.*/jakarta.servlet.jsp.jstl-api-[^/]*\.jar$|.*/jakarta.servlet.jsp.jstl-[^/]*\.jar$</containerIncludeJarPattern>
    </configuration>
</plugin>

3. 分析依赖树确认引入链路 #

执行mvn dependency:tree命令，查看myApp-server模块的依赖树，确认jetty-jakarta-servlet-api的所有引入来源，确保仅保留一处有效引入（比如只保留myApp-jettyMain传递过来的版本）。

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