很多 Java 开发者都遇到过这样的问题： 

本地跑得好好的程序，一打包就报错 

 别慌，这很可能不是你的代码问题，而是——

Maven 提供了多种打可执行 JAR 的方式。今天我们就来对比三种主流方案：

pom.xml 配置 + 执行命令 + 输出结构

<build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.2.0</version>
                <configuration>
                    <archive>
                        <manifest>
                            <mainClass>org.example.App</mainClass>
                            <addClasspath>true</addClasspath>
                            <classpathPrefix>dependencies/</classpathPrefix>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-dependency-plugin</artifactId>
                <version>3.1.1</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>copy-dependencies</goal>
                        </goals>
                        <configuration>
                            <outputDirectory>${project.build.directory}/dependencies/</outputDirectory>
                            <includeScope>runtime</includeScope>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

├── META-INF
│   ├── MANIFEST.MF
│   └── maven
│       └── org.example
│           └── java-demo
│               ├── pom.properties
│               └── pom.xml
└── org
    └── example
        └── App.class

Manifest-Version: 1.0
Created-By: Maven Jar Plugin 3.2.0
Build-Jdk-Spec: 17
Class-Path: dependencies/fastjson2-2.0.60.jar       <-第三方依赖包在这里
Main-Class: org.example.App                         <-启动类

，把你的代码 + 所有依赖的 class 全部塞进去。

<build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-assembly-plugin</artifactId>
                <version>3.1.0</version>
                <configuration>
                    <finalName>java-demo</finalName>
                    <descriptorRefs>
                        <descriptorRef>jar-with-dependencies</descriptorRef>
                    </descriptorRefs>
                    <archive>
                        <manifest>
                            <mainClass>org.example.App</mainClass>
                        </manifest>
                    </archive>
                </configuration>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>single</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

target/
├── java-demo-jar-with-dependencies.jar     ← 可执行 fat jar
└── java-demo-1.0-SNAPSHOT.jar              ← 原始包（不可执行）

📂可执行jar包的解压后长啥样？

Manifest-Version: 1.0
Created-By: Apache Maven 3.9.8
Built-By: Administrator
Build-Jdk: 17.0.11
Main-Class: org.example.App

java -jar java-demo-jar-with-dependencies.jar

，从根本上避免类冲突。类重定位其实就是动态的移动、修改jar包中的类名、包名。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.2.1</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                
                <transformers>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <mainClass>org.example.App</mainClass>
                    </transformer>
                </transformers>
            </configuration>
        </execution>
    </executions>
</plugin>

target/
├── java-demo-1.0-SNAPSHOT.jar           ← 可执行最终包，把项目中的代码及所依赖的第三方jar的Class文件都打进去了
└── original-java-demo-1.0-SNAPSHOT.jar  ← 原始包（备份）,不能直接执行，只包含项目中自有的代码，MENIFEST.MF文件中连Main-Class都没有。

Manifest-Version: 1.0
Created-By: Maven JAR Plugin 3.4.1
Build-Jdk-Spec: 17
Main-Class: org.example.App

如果最终的 jar 包被其他的项目所依赖的话， classpath 中可能存在重复的 class 文件，直接地引用此 jar 包中的类可能会导致类加载冲突。为了解决这个问题，我们可以使用 shade 提供的重定位功能，把部分类移动到一个全新的包中。

<build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>3.2.1</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                        <configuration>
                            <transformers>
                                <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                    <mainClass>org.example.App</mainClass>
                                </transformer>
                            </transformers>
                            <relocations>
                                <relocation>
                                    
                                    <pattern>com.alibaba.fastjson2</pattern>
                                    <shadedPattern>com.asia.fastjson2</shadedPattern>
                                    
                                    <excludes>
                                        <exclude>com.alibaba.fastjson2.JSON</exclude>
                                        <exclude>com.alibaba.fastjson2.filter.*</exclude>
                                    </excludes>
                                </relocation>
                            </relocations>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

.
├── com
│   ├── alibaba
│   │   └── fastjson2
│   │       ├── filter
│   │       └── JSON.class
│   └── asia    
│       └── fastjson2
│           ├── annotation
│           ├── codec
│           ├── function
│           ├── internal
│           ├── 省略。。。
│           ├── TypeReference.class
│           ├── util
│           └── writer
├── META-INF
│   ├── MANIFEST.MF
│   ├── maven
│   │   ├── com.alibaba.fastjson2
│   │   │   └── fastjson2
│   │   └── org.example
│   │       └── java-demo
│   ├── native-image
│   │   └── com.alibaba.fastjson2
│   │       └── fastjson2
│   ├── proguard
│   │   └── fastjson2.pro
│   ├── scm
│   │   └── com.alibaba.fastjson2
│   │       └── fastjson2
│   └── versions
│       └── 9
│           └── module-info.class
├── org
│   └── example
│       └── App.class
└── schema
    ├── 2020-12.json
    └── draft-04.json

三种方式打 Java 可执行 JAR 包，你用对了吗？

写完代码只是开始，如何打包成一个“开箱即用”的 JAR 文件，才是交付的关键一步。

后端

编程语言

开发工具

详解Java打包JAR的三种Maven方案：maven-jar-plugin轻量外置依赖、maven-assembly-plugin全家桶打包、maven-shade-plugin高级防冲突版。对比配置、执行命令和优缺点，帮助开发者选择最适合的打包方式，解决ClassNotFoundException等常见问题。

Spring Boot

JSON

Java

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

三种方式打 Java 可执行 JAR 包，你用对了吗？

三种方式打 Java 可执行 JAR 包，你用对了吗？

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐