类明显存在却报 package not found, Java程序中专门被其他工程所依赖的common jar用spring-boot-maven-plugin打包的注意事项
在使用 Spring Boot 构建通用 JAR 库时,尤其是当通spring boot 默认的过 spring-boot-maven-plugin
插件打包时。如果遇到了类存在但报“package not found”的问题,
可以尝试以下 2 种方式解决。
方式1. spring-boot-maven-plugin
配置
spring-boot-maven-plugin
插件默认用于创建可执行的 JAR 包,这些 JAR 包包含了应用程序的所有依赖。这对于构建一个通用库来说可能并不合适,因为通用库应该是一个标准的 JAR 包,而不是一个可执行的 JAR 包。
示例 pom.xml
配置:
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>common-library</artifactId>
<version>1.0.0</version>
<packaging>jar</packaging>
<dependencies>
<!-- Spring Boot 依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<!-- 其他依赖 -->
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<!-- 禁用可执行 JAR 包的创建 -->
<executions>
<execution>
<id>repackage</id>
<goals>
<goal>repackage</goal>
</goals>
<configuration>
<classifier>exec</classifier>
<skip>true</skip> <!--这一行不写也可以达到目的。不写的话target 目录下不会生成一个jar 和一个 jar.original, 仅仅生成一个传统的 maven jar
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
在这个配置中,通过 skip
属性禁用了可执行 JAR 包的创建,这样会生成一个标准的 JAR 包。
方式2. 使用标准 JAR 打包 ()
如果不需要 Spring Boot 特有的功能,可以直接使用 Maven 的 maven-jar-plugin
来创建 JAR 包,而不是使用 spring-boot-maven-plugin
:
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>3.2.0</version>
<configuration>
<archive>
<manifest>
<addDefaultImplementationEntries>true</addDefaultImplementationEntries>
</manifest>
</archive>
</configuration>
</plugin>
</plugins>
</build>
以上