Maven dependency:analyze误判spring-boot-starter-data-jpa为未使用

原因 #

1. 插件扫描逻辑局限：mvn dependency:analyze仅扫描编译期直接被代码引用的类，而spring-boot-starter-data-jpa是一个依赖聚合器（本身无业务代码），它的作用是引入HikariCP、Hibernate等传递依赖。你的代码直接使用的是这些传递依赖的类，而非Starter本身的类，因此插件会误判Starter为“未使用”，同时又因为传递依赖被直接使用但未在你的pom里显式声明，所以抛出“已使用但未声明”的提示。
2. 对import scope的误解：父pom中的spring-boot-dependencies是用于统一版本管理的，import scope只负责引入版本约束，不会实际引入依赖。把spring-boot-starter-data-jpa设为import scope完全错误，这会导致该依赖根本不会被引入到项目中。

解决办法 #

1. 忽略Starter类依赖的误判 #

最直接的方式是告诉dependency:analyze忽略Spring Boot Starter这类聚合型依赖：

• 临时解决：执行命令时添加参数：

  mvn dependency:analyze -Dmaven.dependency.analyze.ignoreNonCompile
  

  该参数会忽略非编译期直接依赖的聚合型依赖，避免误判。
• 持久化配置：在子模块pom中配置插件，指定忽略特定依赖或启用全局忽略：

  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-dependency-plugin</artifactId>
        <version>3.6.0</version>
        <configuration>
          <!-- 忽略非编译直接依赖的聚合类依赖 -->
          <ignoreNonCompile>true</ignoreNonCompile>
          <!-- 或者单独指定忽略该Starter -->
          <ignoredDependencies>
            <ignoredDependency>org.springframework.boot:spring-boot-starter-data-jpa</ignoredDependency>
          </ignoredDependencies>
        </configuration>
      </plugin>
    </plugins>
  </build>
  

2. 使用Spring Boot官方依赖分析工具 #

Spring Boot提供了专门适配自身依赖结构的分析插件，能准确识别Starter的作用，不会出现误判：
在子模块pom中添加配置：

<build>
  <plugins>
    <plugin>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-maven-plugin</artifactId>
      <version>${spring-boot.version}</version>
      <executions>
        <execution>
          <goals>
            <goal>analyze</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

执行以下命令进行分析：

mvn spring-boot:analyze

3. 显式声明传递依赖（不推荐） #

如果一定要消除插件的报错，可以把HikariCP、hibernate-core等被标记为“已使用未声明”的依赖显式添加到子模块pom中。但这种做法会破坏Spring Boot Starter的封装性，失去自动版本管理的优势，仅在特殊场景下考虑使用。

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