迁移至Java21升级maven-dependency-plugin后出现未声明依赖误报

问题原因 #

升级到maven-dependency-plugin 3.6.+后出现的"Used undeclared dependencies"报错，并非插件bug，而是版本升级后的检测逻辑增强导致：

• 3.1.2版本仅检测代码中显式import的类对应的依赖，而3.6.x版本会深入分析字节码中的所有类引用，包括通过反射、动态代理、继承/实现传递依赖中的类等间接引用场景。
• 你配置了<excludeTransitive>true</excludeTransitive>，插件会忽略所有传递依赖的存在，此时如果字节码中存在对传递依赖类的间接引用，插件就会判定为"未声明依赖"。

解决方法 #

针对这类问题，有三种常见处理方式：

1. 显式声明依赖
   直接在pom.xml中添加被检测到的依赖（比如org.springframework:spring-web），这是Maven推荐的做法，能避免依赖版本漂移问题：

   <dependency>
       <groupId>org.springframework</groupId>
       <artifactId>spring-web</artifactId>
       <version>5.3.30</version>
       <scope>compile</scope>
   </dependency>
   

2. 忽略特定误报依赖
   如果确认某些依赖是无需显式声明的传递依赖，可以通过<ignoredDependencies>配置忽略：

   <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-dependency-plugin</artifactId>
       <version>3.6.1</version>
       <configuration>
           <failOnWarning>true</failOnWarning>
           <excludeTransitive>true</excludeTransitive>
           <ignoredDependencies>
               <ignoredDependency>org.springframework:spring-web</ignoredDependency>
           </ignoredDependencies>
       </configuration>
   </plugin>
   

3. 调整检测范围
   若不需要严格的依赖检测，可以修改插件的analyze-only或ignoreNonCompile等参数缩小检测范围，但这种方式不推荐，会降低依赖检测的严谨性。

补充：很多使用Spring、Spring Boot等框架的项目升级该插件后都会遇到类似问题，因为框架会通过动态代理、自动装配等方式生成引用传递依赖类的字节码。

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