类明显存在却报 package not found, Java程序中专门被其他工程所依赖的common jar用spring-boot-maven-plugin打包的注意事项

先上官方链接:
https://docs.spring.io/spring-boot/docs/2.1.0.RELEASE/maven-plugin/examples/repackage-classifier.html


在使用 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>

以上

posted @ 2024-07-20 18:30  gongchengship  阅读(9)  评论(0编辑  收藏  举报