从Maven仓库Zip提取Jar并整合到SpringBoot项目的Maven配置问题

1. 可以通过单条mvn clean package完成所有步骤 #

你遇到的错误核心有两点：一是Maven依赖解析阶段（validate）早于process-resources阶段，当Maven检查system依赖时，zip还没解压，目标jar文件不存在；二是<scope>system</scope>仅参与编译，不会自动打包进SpringBoot的可执行jar。

以下是修正后的完整pom.xml配置，可一次性完成所有需求：

<dependencies>
    <!-- 移除原有的system依赖，改用build-helper-plugin引入解压后的jar -->
    <!-- 保留你的SpringBoot等其他业务依赖 -->
</dependencies>

<build>
    <plugins>
        <!-- 1. 从Maven仓库下载zip并提前解压到指定目录 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-dependency-plugin</artifactId>
            <executions>
                <execution>
                    <id>unpack-zip</id>
                    <!-- 把解压阶段提前到initialize，确保在编译前完成 -->
                    <phase>initialize</phase>
                    <goals>
                        <goal>unpack</goal>
                    </goals>
                    <configuration>
                        <artifactItems>
                            <artifactItem>
                                <groupId>com.group.HELLO</groupId>
                                <artifactId>HELLO-win-package</artifactId>
                                <version>3.5.1</version>
                                <type>zip</type>
                                <overWrite>false</overWrite>
                                <outputDirectory>${project.build.directory}/unzipped</outputDirectory>
                            </artifactItem>
                        </artifactItems>
                    </configuration>
                </execution>
            </executions>
        </plugin>

        <!-- 2. 将解压后的jar添加为编译依赖，替代system scope -->
        <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>build-helper-maven-plugin</artifactId>
            <version>3.4.0</version>
            <executions>
                <execution>
                    <id>add-external-jar</id>
                    <phase>initialize</phase>
                    <goals>
                        <goal>add-dependency</goal>
                    </goals>
                    <configuration>
                        <dependencies>
                            <dependency>
                                <groupId>com.mycompany</groupId>
                                <artifactId>my-library</artifactId>
                                <version>1.0</version>
                                <scope>compile</scope>
                                <type>jar</type>
                                <location>${project.build.directory}/unzipped/Bin/64bits/lib.jar</location>
                            </dependency>
                        </dependencies>
                    </configuration>
                </execution>
            </executions>
        </plugin>

        <!-- 3. 配置SpringBoot插件，确保外部jar被打包进可执行jar -->
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <mainClass>com.local.work.service.BTKServiceApplication</mainClass>
                <!-- 显式指定要包含的外部依赖，避免被遗漏 -->
                <includes>
                    <include>
                        <groupId>com.mycompany</groupId>
                        <artifactId>my-library</artifactId>
                    </include>
                </includes>
            </configuration>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

关键配置说明： #

• 把zip解压阶段移到initialize，确保在Maven依赖解析和编译前完成，解决文件不存在的问题。
• 使用build-helper-maven-plugin将解压后的jar注册为正常编译依赖，替代system scope，让Maven全程识别该依赖。
• 通过SpringBoot插件的<includes>配置，强制将该jar打包进最终的可执行jar，保证java -jar运行时能加载到它。

2. 若单命令方案遇到问题的手动步骤 #

如果因插件版本兼容等问题导致单命令失败，可分两步执行：

1. 先执行mvn initialize，完成zip的下载和解压操作。
2. 再执行mvn clean package，此时解压后的jar已存在，可正常完成编译和打包。

对应的pom.xml只需保留上述配置即可，无需额外修改。

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