Maven requireUnpack使用方法及Spring Boot pom.xml配置技术咨询

我来给你详细拆解Maven里的requiresUnpack（准确来说是Spring Boot Maven插件的核心配置项）怎么用，再结合你提供的pom片段给出针对性的实操指导。

一、先搞懂requiresUnpack到底干啥用 #

在Spring Boot项目默认打包逻辑里，所有依赖都会以完整jar包的形式塞进最终可执行jar的BOOT-INF/lib目录。但有些特殊依赖——比如你用的本地系统jar、带native资源的jar，或者运行时需要直接读取内部文件的依赖——必须被解包到BOOT-INF/classes目录才能正常工作，这时候requiresUnpack就是用来指定这些需要特殊处理的依赖的。

二、针对你的配置的具体操作步骤 #

你当前引入了一个system scope的本地jar：

<dependency>
    <groupId>pps.model</groupId>
    <artifactId>model</artifactId>
    <version>1.0</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/libs/pps.jar</systemPath>
</dependency>

先划重点：system scope的依赖默认不会被Spring Boot打包到最终产物里，所以我们要做两步：让插件把这个依赖打包进去 + 配置解包规则。

步骤1：配置Spring Boot Maven插件，包含并解包你的系统依赖 #

找到pom里的spring-boot-maven-plugin，补充以下配置：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <version>你的Spring Boot版本号</version>
    <configuration>
        <!-- 关键：让插件包含system scope的依赖 -->
        <includeSystemScope>true</includeSystemScope>
        <!-- 指定需要解包的依赖 -->
        <requiresUnpack>
            <dependency>
                <groupId>pps.model</groupId>
                <artifactId>model</artifactId>
            </dependency>
        </requiresUnpack>
    </configuration>
    <executions>
        <execution>
            <goals>
                <goal>repackage</goal>
            </goals>
        </execution>
    </executions>
</plugin>

步骤2：requiresUnpack的配置细节 #

• 只需要指定依赖的groupId和artifactId就行，版本可以省略（只要项目里只引入了这个版本的依赖）。
• 如果有多个需要解包的依赖，直接在<requiresUnpack>下多加几个<dependency>节点就好。
• 解包后的内容会被放到最终jar的BOOT-INF/classes目录，类加载器能直接访问里面的类和资源文件。

三、额外的优化建议（推荐） #

其实用system scope依赖不太友好——它绑定本地文件，团队协作或者CI/CD环境很容易出问题。更稳妥的方案是：

1. 把本地的pps.jar安装到你的本地Maven仓库，执行这条命令：

   mvn install:install-file -Dfile=./libs/pps.jar -DgroupId=pps.model -DartifactId=model -Dversion=1.0 -Dpackaging=jar
   

2. 然后把pom里的依赖改成普通的compile scope：

   <dependency>
       <groupId>pps.model</groupId>
       <artifactId>model</artifactId>
       <version>1.0</version>
   </dependency>
   

这样既不用依赖本地文件，也能正常使用requiresUnpack（如果还是需要解包的话），项目的可移植性强多了。

内容的提问来源于stack exchange，提问作者Rafael Nechi Verceze