在日常开发里Fat JAR是hen多团队的救星。它把业务代码、第三方依赖、连同内嵌的 Tomcat/Jetty 一起塞进一个 JAR，部署时只要一条 java -jar xxx.jar 命令，整个系统瞬间活了起来。下面我把亲身踩过的坑、收集的技巧全部拆开来聊，让你在 30 分钟之内就Neng把自己的 SpringBoot 项目变成可搬运的独立执行体。

传统的 WAR 包往往需要外部容器配合才Neng跑，这意味着：

服务器上必须预装对应容器；

不同环境的配置文件容易不一致；

升级或回滚时要同步检查容器版本。

而 Fat JAR 把「容器」也装进去，只需 JRE 就Neng启动。对微服务、Docker 化以及 CI/CD 流水线dou有极大好处——一次构建，多处运行。

全依赖自带不再担心缺 jar；

启动快如闪电SpringBoot 自带的类加载器专门为 Jar‑in‑Jar 场景Zuo了优化；

部署无痛本地机器、云服务器甚至裸机，dou只要一条命令。

下面先确保你的项目Yi经引入了 SpringBoot 的父 POM，并且使用的是 Maven 构建工具。Ru果你习惯用 Gradle，只需要把对应插件换成 org.springframework.boot.gradle.plugin，思路完全一样。

    
        
            org.springframework.boot
            spring-boot-maven-plugin
            ${spring.boot.version}
            
                true
                true
            
            
                
                    
                        repackage
                    
                
            
        
        
            org.apache.maven.plugins
            maven-dependency-plugin
            
                
                    copy-local-jars
                    process-resources
                    /elementaryGoal>

⚡ 小贴士：Ru果你真的有系统范围依赖，一定记得打开 &l t;i n c l u d e S y s t e m S c o p e , 否则这些库会被悄悄丢掉。

打开「Maven Projects」面板，展开「Lifecycle」节点；

双击「package」或直接点右键选择「Run 'package'」；

Maven 会先编译源码，然后执行上面插件的 repackage 阶段，目标目录里会生成类似 {project}-0.0.1-SNAPSHOT.jar.

打开终端，输入 java -jar target/xxx.jar --spring.profiles.active=prod, kankan日志是否顺利启动。

Ru果你想让生成的 jar 可直接双击运行，只要在插件配置里加上 `true` 即可——系统会给 JAR 加上一个小巧的启动脚本。

Maven 插件在打完包后会产生一个特殊目录布局：

BOOT-INF/
│── classes/          // 编译后的业务类
│── lib/              // 所有依赖 jar
│── resources/        // 资源文件
META-INF/
│── MANIFEST.MF       // 主入口指向 org.springframework.boot.loader.JarLauncher
BOOT-INF/classes/
└── com/example/Application.class
...

BooT‑INF/lib/* - 这里存放的是所有第三方 jar。SpringBoot 自带的类加载器会在运行时把它们当作子 ClassLoader 加载，从而实现「Jar in Jar」的奇迹。

💡 小实验：随便删掉 BOOT-INF/lib 中某个常用依赖，然后重新跑一下你会kan到清晰友好的 “ClassNotFoundException”，这正是调试缺失依赖时Zui直观的方法。

Maven 插件默认把所有 compile / runtime 范围内的 jar dou放进去，但实际生产中我们可Neng想：

排除大体积库：比如某些仅用于测试或本地开发的工具；

Piggyback 特定资源：aop‑weaver 或者 logback 配置文件，需要单独放到根路径下才Neng被自动读取。

A) 排除方式示例：

   &l t;p a c k a g e i n c l u d e s&e n d;&g t ;
   ...
   // 排除 log4j-core，因为我们改用了 logback
   +log4j-core
&l t ;/configuration&g t ; 
...
&l t ;dependencies&g t ;
   ...
   +log4j-core 
&l t ;/dependencies&g t ;
...
 
   ... 
    // 自己写逻辑读取属性
 

B) 想让某些资源直接挂在 JAR 根目录，只需要在 pom 中加入如下拷贝指令：

&l t ;build&g t ;
   ...
   l i b r a r y s>
      l i b r a r y>
         g r o u p I D>org.projectlombok
         a r ? ? ? ? 
      
      ...  
      c o p y -
      s p e c i f i c ation>
         d i r>src/main/resources/custom-configs
         outpu tp ath>${project.build.outputDirectory}
      
   
...

# 打包并立即运行
mvn spring-boot:run
# 或者先打好肥包，再跑：
java -jar target/myapp-1.0.0.jar \
     --server.port=8085 \
     --spring.profiles.active=dev \
     --logging.level.root=INFO

FROM eclipse-temurin:17-jre-alpine
COPY target/myapp-1.0.0.jar /app/app.jar
ENTRYPOINT 
EXPOSE 8080