mvn打jar包示例:依赖打入jar包和依赖打到外部文件夹

本文详细讲解了在使用Maven打包Java项目时,外部依赖与源码一起打包的两种方式,包括各自的POM配置和实际效果,帮助开发者理解如何选择适合的打包策略。

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

使用maven打包java的jar包时,通常有两种情况:

将依赖打到外部文件夹,将源码单独打jar包运行;

将依赖和源码一起打到jar包中运行。

下面举例说明这两种情况:

建立如下测试类,依赖一个common-lang包(用于测试外部依赖):

package mvnDemo;

import org.apache.commons.lang3.StringUtils;

public class MvnDemo {

    public static void main(String[] args) {
        System.out.println(StringUtils.upperCase("hello mvn"));
    }
}

POM配置如下:

<?xml version="1.0" encoding="UTF-8"?>
<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>org.example</groupId>
    <artifactId>testDemo</artifactId>
    <version>1.0-SNAPSHOT</version>

    <dependencies>
        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-lang3</artifactId>
            <version>3.11</version>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>RELEASE</version>
            <scope>compile</scope>
        </dependency>

    </dependencies>
    <build>
        <plugins>
            <!--指定项目源码的jdk版本和编译后的jdk版本。-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>8</source>
                    <target>8</target>
                </configuration>
            </plugin>

            <!--指定打成jar包的mainClass;设置添加classpath;设置classpath的前缀
            https://maven.apache.org/plugins/maven-jar-plugin/-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.2.0</version>
                <configuration>
                    <archive>
                        <manifest>
                            <mainClass>
                                mvnDemo.MvnDemo
                            </mainClass>
                            <addClasspath>
                                true
                            </addClasspath>
                            <classpathPrefix>
                                lib
                            </classpathPrefix>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>

            <!--将所需依赖拷贝到当前jar包所在目录的lib文件夹下。
            maven官网示例地址: https://maven.apache.org/plugins/maven-dependency-plugin/examples/copying-project-dependencies.html-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-dependency-plugin</artifactId>
                <version>3.2.0</version>
                <executions>
                    <execution>
                        <id>copy-dependencies</id>
                        <phase>package</phase>
                        <goals>
                            <goal>copy-dependencies</goal>
                        </goals>
                        <configuration>
                            <outputDirectory>${project.build.directory}/lib</outputDirectory>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

            <!--将所需依赖一并打到jar包中。
            mvn官网案例 https://maven.apache.org/plugins/maven-shade-plugin/-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>3.2.4</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                        <configuration>
                            <filters>
                                <filter>
                                    <artifact>*:*</artifact>
                                    <excludes>
                                        <exclude>META-INF/*.SF</exclude>
                                        <exclude>META-INF/*.DSA</exclude>
                                        <exclude>META-INF/*.RSA</exclude>
                                    </excludes>
                                </filter>
                            </filters>
                            <transformers>
                                <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                    <mainClass>mvnDemo.MvnDemo</mainClass>
                                </transformer>
                            </transformers>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

</project>

打完的jar如下:

lib中存放的是相关依赖jar包(比如common-lang包);

original-testDemo-1.0-SNAPSHOT.jar是仅含源码的jar包;

testDemo-1.0-SNAPSHOT.jar是既包含源码又包含相关依赖的jar包。

上述两个jar包分别使用java -jar original-testDemo-1.0-SNAPSHOT.jar  java -jar testDemo-1.0-SNAPSHOT.jar运行都能得到

HELLO MVN

的运行结果。

<think>好的,我现在需要帮用户解决如何将微服务项目打JAR文件,特别是使用Spring BootMaven的情况。首先,用户的问题集中在打过程上,可能涉及到Spring Boot Maven插件的配置使用。我需要回忆一下相关的步骤配置。 首先,我应该确认用户的项目结构是否符合Maven的标准结构,也就是src/main/javapom.xml的位置是否正确。因为如果项目结构不对,Maven可能无法正确打。接下来,用户需要在pom.xml中设置打方式为jar,默认就是jar,但显式声明可以避免问题。然后,关键的一步是添加Spring Boot Maven插件,这个插件负责将依赖进可执行的JAR中,并且处理启动类等配置。 根据引用[4],默认的配置只需要在pom.xml的build部分添加插件声明。用户可能已经有一个基本的插件配置,但需要确认是否正确。另外,如果用户需要分层构建,比如优化Docker镜像,可能需要启用layers配置,如引用[3]所示。但用户的问题可能主要是打JAR,所以分层可能是进阶内容。 接下来,用户可能想知道具体的操作步骤。我应该分步骤说明:检查项目结构、配置pom.xml、执行Maven命令。同时,用户可能会遇到常见问题,比如依赖没有被打进去,这时候需要确认插件是否正确配置,以及是否使用了正确的命令(mvn clean package)。 另外,引用[2]提到,插件会替换原有的JAR,生成可执行的fat JAR。这点需要强调,避免用户疑惑为什么原来的JAR不能运行。同时,启动类的配置也是关键,如果主类没有正确指定,JAR可能无法启动,这需要检查@SpringBootApplication注解pom中的配置。 用户可能还想知道如何验证生成的JAR是否正确,比如使用java -jar命令运行,并检查依赖是否含在内。还有可能的问题是关于多模块项目的处理,是否需要每个模块单独配置插件,或者在父POM中统一管理。这时候需要说明在父POM或子模块中添加插件的方式。 最后,根据用户提供的引用内容,我需要确保引用正确的部分,比如引用[1]说明插件的作用,引用[4]给出默认配置示例。可能还需要提到分层打作为扩展内容,但主要回答集中在基本打流程上。同时,生成的相关问题要涵盖性能优化、Docker集成多模块处理,这些都是用户后续可能关心的问题。</think>### 如何将微服务项目打为可执行JAR文件(Spring Boot + Maven) #### 1. 基础配置步骤 **1.1 确保项目结构符合Maven标准** ``` 项目根目录 ├── src │ └── main │ ├── java # 源代码目录 │ └── resources # 配置文件目录 └── pom.xml # Maven配置文件 ``` **1.2 配置pom.xml** ```xml <project> <!-- 指定打方式为JAR --> <packaging>jar</packaging> <build> <plugins> <!-- 核心:Spring Boot Maven插件 --> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <version>3.1.0</version> <!-- 与Spring Boot版本一致 --> </plugin> </plugins> </build> </project> ``` *注:该配置会自动将依赖打入JAR文件(fat JAR)[^2][^4]* #### 2. 高级配置选项 **2.1 分层打(Docker优化)** ```xml <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <configuration> <layers> <enabled>true</enabled> <configuration>${project.basedir}/src/layers.xml</configuration> </layers> </configuration> </plugin> ``` *作用:将依赖、资源文件、应用代码分层,提升容器构建效率[^3]* **2.2 自定义主类** ```xml <configuration> <mainClass>com.example.MicroserviceApplication</mainClass> </configuration> ``` *需与@SpringBootApplication标注的启动类一致* #### 3. 打命令 ```bash mvn clean package # 标准打命令 mvn package -DskipTests # 跳过测试打 ``` 生成路径:`target/[项目名]-[版本].jar` #### 4. 验证JAR文件 ```bash java -jar target/demo-0.0.1-SNAPSHOT.jar ``` 成功运行应显示Spring Boot启动日志: ``` Started MicroserviceApplication in 2.534 seconds ``` #### 常见问题排查 | 现象 | 解决方案 | |-----------------------|---------------------------------| | JAR文件无法找到主类 | 检查`<mainClass>`配置是否正确 | | 依赖打入JAR | 确认插件配置在`<build>`标签内 | | 启动时配置加载失败 | 检查src/main/resources目录结构 |
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值