打包jar包时无法吧依赖打进jar包中问题处理

最新推荐文章于 2025-06-11 17:12:58 发布

原创最新推荐文章于 2025-06-11 17:12:58 发布 · 3k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#java #spring #jar

问题专栏收录该内容

65 篇文章

订阅专栏

本文介绍如何使用Maven-assembly-plugin解决本地依赖包打包问题，通过自定义配置将scope为system的依赖一并打包，避免遗漏。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

最近在修改一个小工具，原来的做法是把依赖包都下载到本地目录，打包时候使用fatjar打包整个项目依赖；现在修改为maven管理依赖包，使用maven-assembly-plugin插件打包；如果依赖包全部是远程默认的依赖配置，这样没有问题；但里面有些是自己实现的本地依赖，这个时候打包就有问题了；因为本地依赖包scope配置为system，而默认的配置为runtime，所以本地依赖包没有打进去

处理方案：使用自定义配置替代maven-assembly-plugin的默认配置

默认配置：

            <plugin>
                <artifactId>maven-assembly-plugin</artifactId>
                <configuration>
                    <archive>
                        <manifest>
                            <mainClass>主程序入口方法</mainClass>
                        </manifest>
                        <manifestEntries>
                            <Class-Path>.</Class-Path>
                        </manifestEntries>
                    </archive>
                    <descriptorRefs>
                        <descriptorRef>jar-with-dependencies</descriptorRef>
                    </descriptorRefs>
                </configuration>
                <executions>
                    <execution>
                        <id>make-assembly</id>
                        <phase>package</phase>
                        <goals>
                            <goal>single</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>

增加assembly.xml 文件配置如下：

<assembly>
    <id>jar-with-dependencies</id>
    <formats>
        <format>jar</format>
    </formats>
    <includeBaseDirectory>false</includeBaseDirectory>
    <dependencySets>
        <!-- 默认的配置 -->
        <dependencySet>
            <outputDirectory>/</outputDirectory>
            <useProjectArtifact>true</useProjectArtifact>
            <unpack>true</unpack>
            <scope>runtime</scope>
        </dependencySet>
        <!-- 增加scope类型为system的配置 -->
        <dependencySet>
            <outputDirectory>/</outputDirectory>
            <useProjectArtifact>true</useProjectArtifact>
            <unpack>true</unpack>
            <scope>system</scope>
        </dependencySet>
    </dependencySets>
</assembly>

可以看到，主要增加了scope类型为system的配置；这样在打包的时候，就会把本地jar也打包进去

当然默认的配置也是可以使用的，这个时候可以把本地依赖上传到maven仓库；然后将dependency中路径和scope配置去掉；这样就可以使用默认配置进行打包，可以实现以上同样效果

完整build:

    <build>
        <sourceDirectory>src</sourceDirectory>
        <resources>
            <resource>
                <filtering>true</filtering>
                <directory>src/resources</directory>
                <includes>
                    <include>*.*</include>
                </includes>
            </resource>
        </resources>
 
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-dependency-plugin</artifactId>
                <executions>
                    <execution>
                        <id>copy-dependencies</id>
                        <phase>package</phase>
                        <goals>
                            <goal>copy-dependencies</goal>
                        </goals>
                        <configuration>
                            <outputDirectory>${project.build.directory}/lib</outputDirectory>
                            <overWriteReleases>false</overWriteReleases>
                            <overWriteSnapshots>false</overWriteSnapshots>
                            <overWriteIfNewer>true</overWriteIfNewer>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <artifactId>maven-assembly-plugin</artifactId>
                <configuration>
                    <archive>
                        <manifest>
                            <mainClass>com.quan.simple.IncFrame</mainClass>
                        </manifest>
                        <manifestEntries>
                            <Class-Path>.</Class-Path>
                        </manifestEntries>
                    </archive>
                    <!--<descriptorRefs>
                        <descriptorRef>jar-with-dependencies</descriptorRef>
                    </descriptorRefs>-->
                </configuration>
                <executions>
                    <execution>
                        <id>make-assembly</id>
                        <phase>package</phase>
                        <goals>
                            <goal>single</goal>
                        </goals>
                        <configuration>
                            <descriptors>
                                <descriptor>src/assembly/assembly.xml</descriptor>
                            </descriptors>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
 
        </plugins>
    </build>

原文：https://blog.youkuaiyun.com/w_quan/article/details/83306213