【Spring Boot JAR 解压修改配置后重新打包全流程（避坑指南）】
Spring 博客笔记：Spring Boot JAR 解压修改配置后重新打包全流程（避坑指南）
在开发或部署 Spring Boot 项目时，经常需要解压 JAR 包修改配置文件（如数据库连接、端口等），再重新打包启动。但手动操作很容易踩坑（比如启动类缺失、嵌套 JAR 压缩错误），这里梳理一套完整的 Windows 环境下操作流程，附常见问题解决方法。
一、核心流程：解压 → 修改 → 正确打包
1. 第一步：解压 JAR 包（保持目录结构）
先在 JAR 包同级目录新建 unpacked 文件夹，用于存放解压后的文件，避免文件混乱：
# 1. 新建解压目录（若已存在则跳过）
mkdir unpacked# 2. 进入解压目录
cd unpacked# 3. 解压 JAR 包（..\fbsgf_sync.jar 是原 JAR 路径，根据实际修改）
jar xf ..\fbsgf_sync.jar
解压后会看到 Spring Boot 标准目录结构：
unpacked/
├─ META-INF/ # 清单文件、签名等（关键：含 MANIFEST.MF）
├─ BOOT-INF/ # 项目核心内容
│ ├─ classes/ # 你的代码编译后的 class、配置文件（要修改的在这里）
│ └─ lib/ # 依赖 JAR（如 HikariCP、spring-core 等，不可压缩）
└─ org/ # Spring Boot 启动器（含 JarLauncher，必须保留）
2. 第二步：修改配置文件
找到 BOOT-INF/classes 目录下需要修改的配置文件（如 application.yml、application-ysj.yml），直接用记事本或 IDE 编辑：
# 示例：修改 application-ysj.yml（路径根据实际配置文件调整）
notepad BOOT-INF/classes/application-ysj.yml
⚠️ 注意：只修改 BOOT-INF/classes 下的文件，不要删改 BOOT-INF/lib、org、META-INF 目录的内容，否则会导致启动失败。
3. 第三步：关键！正确重新打包（避坑核心）
手动打包最容易出问题，必须满足两个条件：
- 包含
org目录（Spring Boot 启动器JarLauncher在这）； BOOT-INF/lib下的依赖 JAR 不压缩（用0参数指定）；- 显式指定
META-INF/MANIFEST.MF作为清单文件（含主类配置）。
在 unpacked 目录执行以下一行命令：
# 格式：jar c0fm 输出JAR路径 清单文件路径 要打包的目录
jar c0fm ../fbsgf_sync-fixed.jar META-INF/MANIFEST.MF org BOOT-INF META-INF
命令参数说明：
c：创建新 JAR 包；0：不压缩文件（关键！确保BOOT-INF/lib依赖正常加载）；f：指定输出 JAR 文件名（../fbsgf_sync-fixed.jar表示输出到上级目录）；m：指定清单文件（META-INF/MANIFEST.MF，含Main-Class: org.springframework.boot.loader.JarLauncher）；- 最后三个参数
org BOOT-INF META-INF：把这三个目录完整打包（缺一不可）。
二、打包后验证：确保没问题再启动
打包完成后，先验证两个关键点，避免白跑一趟：
1. 验证 1：是否包含启动器 JarLauncher
检查输出的 JAR 包中是否有 org/springframework/boot/loader/JarLauncher.class：
# 回到上级目录（JAR 包所在目录）
cd ..# 查看 JAR 包内容，筛选启动类
jar tf fbsgf_sync-fixed.jar | findstr "JarLauncher.class"
如果输出以下内容，说明启动器正常包含：
org/springframework/boot/loader/JarLauncher.class
2. 验证 2：启动 JAR 包
执行启动命令，测试是否正常：
java -jar fbsgf_sync-fixed.jar
如果看到 Spring Boot 启动日志（如 Started Application in XX seconds），说明流程成功；若报错，参考下面的“常见问题”解决。
三、常见问题及解决方案
问题 1：启动报“找不到或无法加载主类 org.springframework.boot.loader.JarLauncher”
- 原因：打包时漏掉
org目录，或org目录路径不对。 - 解决：重新打包时，确保命令最后包含
org目录（如jar c0fm ... org BOOT-INF META-INF）。
问题 2：启动报“Unable to open nested jar file ‘BOOT-INF/lib/XXX.jar’”
- 原因：打包时用了压缩（没加
0参数），导致BOOT-INF/lib依赖无法加载。 - 解决：重新打包时必须加
0参数（如jar c0fm ...），确保依赖不压缩。
问题 3：启动报“XXX.jar 中没有主清单属性”
- 原因：打包时没指定
m参数和清单文件，JVM 找不到主类。 - 解决：打包命令中必须包含
m META-INF/MANIFEST.MF（如jar c0fm ... META-INF/MANIFEST.MF ...）。
四、总结
手动解压修改 Spring Boot JAR 包的核心是“不删改关键目录+正确打包参数”：
- 只改
BOOT-INF/classes下的配置； - 打包用
jar c0fm命令，包含org BOOT-INF META-INF三个目录； - 打包后先验证启动器是否存在，再启动。
按这个流程走，能避开 90% 以上的手动打包问题，比反复试错高效得多～