Maven 依赖分离的两种方式

更新时间：2026年07月15日 09:35:35 作者：zhougl996

本文主要介绍了Maven 依赖分离的两种方式,包括用通用方案或SpringBoot专属配置,把主Jar和依赖lib分开放,优化Docker镜像构建、加速传输,感兴趣的可以了解一下

插件配置

复制依赖到 target/lib 目录
配置主 Jar 的 Class-Path 和 Main-Class

Maven 依赖分离是指将项目的 核心代码（主 Jar） 与 第三方依赖库（依赖 Jar） 分离到不同目录，而非打包在同一个文件中。这种方式常用于优化部署、减少重复传输、或配合 Docker 镜像分层构建。

以下是两种最常用的实现方案：

方案一：使用maven-dependency-plugin（通用方案）

适用于所有 Maven 项目，通过插件将依赖复制到指定目录，并配置主 Jar 的 Class-Path 指向该目录。

1. 配置pom.xml

在 <build><plugins> 中添加以下两个插件：

<project>
    <!-- ... 其他配置 ... -->
    <build>
    		 <!-- 配置target的文件位置 -->
    		 <directory>${basedir}/target</directory>
        <plugins>
            <!-- 1. 复制依赖到 target/lib 目录 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-dependency-plugin</artifactId>
                <version>3.6.0</version>
                <executions>
                    <execution>
                        <id>copy-dependencies</id>
                        <phase>package</phase> <!-- 绑定到 package 阶段 -->
                        <goals>
                            <goal>copy-dependencies</goal>
                        </goals>
                        <configuration>
                            <!-- 依赖输出目录 -->
                            <outputDirectory>${project.build.directory}/lib</outputDirectory>
                            <!-- 是否包含传递性依赖 -->
                            <includeScope>runtime</includeScope>
                            <!-- 保持依赖的原有文件名 -->
                            <overWriteReleases>false</overWriteReleases>
                            <overWriteSnapshots>false</overWriteSnapshots>
                            <overWriteIfNewer>true</overWriteIfNewer>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <!-- 2. 配置主 Jar 的 Class-Path 和 Main-Class -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.3.0</version>
                <configuration>
                    <archive>
                        <manifest>
                            <!-- 程序入口类 -->
                            <mainClass>com.example.YourMainClass</mainClass>
                            <!-- 自动添加 Class-Path -->
                            <addClasspath>true</addClasspath>
                            <!-- Class-Path 中依赖的前缀目录 -->
                            <classpathPrefix>lib/</classpathPrefix>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

关键配置说明

配置项	作用
`<includeScope>runtime</includeScope>`	仅复制运行时需要的依赖（`compile` 和 `runtime` 范围），排除 `test`（测试用）和 `provided`（容器提供）的依赖。
`<classpathPrefix>lib/</classpathPrefix>`	告诉主 Jar 去 `lib/` 目录下找依赖，必须与 `outputDirectory` 的目录名一致。
`<useBaseVersion>true</useBaseVersion>`	避免 SNAPSHOT 版本的依赖文件名带时间戳（如 `1.0-20240101.123456-1.jar`），保持文件名简洁。

2. 执行打包

运行 mvn clean package，你会在 target 目录下看到：

your-app.jar（你的主程序，体积很小）
lib/（包含所有依赖的 Jar 包）

3. 运行方式

将 your-app.jar 和 lib/ 放在同一目录下，执行：

java -jar your-app.jar

方案二：Spring Boot 项目专用（spring-boot-maven-plugin）

如果是 Spring Boot 项目，默认插件会把所有依赖打进一个 Fat Jar。若需分离，需调整插件配置。

1. 配置pom.xml

<project>
    <!-- ... 其他配置 ... -->
    <build>
        <plugins>
            <!-- Spring Boot 插件 -->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <!-- 1. 启用分层打包（Layered Jars） -->
                    <layers>
                        <enabled>true</enabled>
                    </layers>
                    <!-- 或者 2. 使用 Properties 配置（旧版本方式） -->
                    <!-- <requiresUnpack>
                        <dependency>
                            <groupId>com.example</groupId>
                            <artifactId>some-large-lib</artifactId>
                        </dependency>
                    </requiresUnpack> -->
                </configuration>
            </plugin>
            <!-- 配合复制依赖插件（可选，若需物理分离） -->
            <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>
                            <includeScope>runtime</includeScope>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

2. Spring Boot 分层 Jar 说明

Spring Boot 的 layers 模式虽然不直接物理分离文件，但内部将 Jar 分为了不同层（如 dependencies、spring-boot-loader、snapshot-dependencies、application），非常适合 Docker 镜像构建，能利用缓存加速。

如果需要物理分离（像方案一那样 lib 目录在外），建议直接使用 方案一 的通用配置，Spring Boot 项目同样兼容。

总结

普通项目：推荐 方案一，结构清晰，运行简单。
Spring Boot + Docker：推荐使用 layers 分层模式，优化镜像构建速度。
注意：分离后部署时，务必保证 lib 目录和主 Jar 的相对位置与 classpathPrefix 配置一致。

到此这篇关于Maven 依赖分离的两种方式的文章就介绍到这了,更多相关Maven 依赖分离内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

springmvc处理异步请求的示例
这篇文章主要介绍了springmvc处理异步请求的示例，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-01-01
详解IDEA 中使用Maven创建项目常见错误和使用技巧(推荐)
这篇文章主要介绍了详解IDEA 中使用Maven创建项目常见错误和使用技巧(推荐)，本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
2020-07-07
SpringBoot使用自动配置xxxAutoConfiguration
这篇文章介绍了SpringBoot自动配置xxxAutoConfiguration的使用方法，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2021-12-12
SpringBoot整合RabbitMQ实战教程附死信交换机
这篇文章主要介绍了SpringBoot整合RabbitMQ实战附加死信交换机,本文通过示例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2022-06-06
smslib发短信实例代码(电脑发短信)
smslib发短信实例，大家可以参考使用开发自己的程序
2013-12-12
解读CompletableFuture异步多线程的使用方式
这篇文章主要介绍了CompletableFuture异步多线程的使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-07-07
灵活控制任务执行时间的Cron表达式范例
这篇文章主要为大家介绍了灵活控制任务执行时间的Cron表达式范例,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
2023-10-10
java通过poi解析word入门的操作方法
Apache POI 是一个处理Miscrosoft Office各种文件格式的开源项目,可以使用POI在Java程序中对Miscrosoft Office各种文件进行读写操作,本文给大家介绍java通过poi解析word入门的操作方法,感兴趣的朋友一起看看吧
2024-08-08
Java ObjectMapper的使用和使用过程中遇到的问题
在Java开发中,ObjectMapper是Jackson库的核心类,用于将Java对象序列化为JSON字符串,或者将JSON字符串反序列化为Java对象,这篇文章主要介绍了Java ObjectMapper的使用和使用过程中遇到的问题,需要的朋友可以参考下
2024-07-07
Java 中如何创建按钮单击事件
我们使用事件侦听器在Java中创建按钮单击事件，本文给大家讲解Java中的按钮单击事件,结合示例代码给大家介绍的非常详细，需要的朋友可以参考下
2023-05-05