Maven项目如何自动将传递依赖纳入类路径？解决运行时依赖缺失问题

1. 排查依赖范围问题 #

传递依赖缺失最常见的原因是目标依赖被设置了provided或test范围——这两类范围的依赖仅在编译/测试阶段生效，不会被纳入运行时类路径。

• 执行命令 mvn dependency:tree -Dincludes=com.example:a.1（替换为A.1的实际groupId和artifactId），查看其依赖范围。
• 若确为范围问题：
  • 如果你能修改Dependency A的源码，直接调整其pom中A.1的依赖范围为compile；
  • 若无法修改A的pom，可使用maven-shade-plugin将所有依赖（包括传递依赖）打包进最终可执行jar，配置示例：

    <build>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-shade-plugin</artifactId>
          <version>3.4.1</version>
          <executions>
            <execution>
              <phase>package</phase>
              <goals>
                <goal>shade</goal>
              </goals>
              <configuration>
                <transformers>
                  <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                    <mainClass>com.your.package.YourSpringMainClass</mainClass>
                  </transformer>
                </transformers>
              </configuration>
            </execution>
          </executions>
        </plugin>
      </plugins>
    </build>
    

2. 检查Spring Boot打包配置 #

如果是Spring Boot项目，默认的spring-boot-maven-plugin会自动打包所有依赖，但可能存在误排除的情况：

• 检查插件配置中是否有<excludeGroupIds>或<excludeArtifactIds>节点，排除了A或A.1的依赖；
• 执行jar tf your-spring-app.jar | grep "com/example/a1"（替换为A.1的包路径），确认A.1的class文件是否在打包后的jar中；
• 若未包含，可在插件配置中添加<includes>节点明确包含A的依赖，或移除不必要的排除规则。

3. 清理Maven缓存 #

本地Maven仓库中的依赖jar可能损坏，导致编译时能读取但运行时无法加载类：

• 执行命令 mvn clean install -U，-U参数会强制更新快照依赖并清理本地缓存；
• 也可手动删除本地仓库中Dependency A和A.1对应的文件夹，再重新执行mvn install。

4. 解决依赖冲突导致的自动排除 #

Maven会自动排除版本冲突的依赖，可能导致A.1被意外排除：

• 执行mvn dependency:tree查看依赖树，查找A.1是否被标记为(omitted for conflict)；
• 若存在冲突，在项目的<dependencyManagement>中统一指定A.1的正确版本，让Maven优先选择该版本而非排除它，示例：

  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>com.example</groupId>
        <artifactId>a.1</artifactId>
        <version>x.y.z</version>
      </dependency>
    </dependencies>
  </dependencyManagement>
  

5. 手动收集所有传递依赖（非打包场景） #

如果是手动运行Spring应用而非打包成可执行jar，可通过Maven命令自动收集所有依赖：

• 执行mvn dependency:copy-dependencies，该命令会将所有依赖（包括传递依赖）复制到target/dependency目录；
• 运行应用时指定类路径：java -cp target/your-app.jar:target/dependency/* com.your.package.Application

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