使用Install4j打包Java Jar应用运行EXE时遭遇ClassNotFoundException

核心原因 #

Spring Boot可执行Jar的结构和标准Java Jar不同：类文件存放在BOOT-INF/classes目录下，依赖Jar在BOOT-INF/lib下。普通的类路径模式无法正确加载这种特殊结构里的主类，但java -jar命令会通过Spring Boot内置的JarLauncher自动处理该结构，所以能正常运行。

解决方案 #

方案1：使用Install4j的「可执行JAR」模式配置启动器（推荐）

1. 打开Install4j的启动器配置，切换到Java调用标签页
2. 主类选择**「可执行JAR」**模式，点击「浏览」选择你的Spring Boot可执行Jar文件
3. 保留参数--spring.profiles.active=staging，无需手动填写主类
4. 重新构建安装包并测试

这种方式会让Install4j自动调用Spring Boot的引导类，完美适配其特殊Jar结构，避免手动配置主类和类路径的错误。

方案2：解压Spring Boot Jar后配置类路径（适合自定义类路径场景）

如果必须用「类路径」模式，需要先处理Jar结构：

1. 将Spring Boot可执行Jar解压到一个目录（比如app-unpacked）
2. 在Install4j的文件配置中，把解压后的BOOT-INF/classes目录、BOOT-INF/lib下的所有依赖Jar，以及你的资源文件都部署到安装目录
3. 在启动器的Java调用→类路径中，添加BOOT-INF/classes目录和BOOT-INF/lib下的所有Jar文件
4. 主类填写Spring Boot项目中实际的主类全限定名（比如com.example.MyApplication，不要加BOOT-INF.classes.前缀）
5. 重新构建安装包测试

方案3：检查类路径条目路径是否正确

确保启动器中添加的类路径条目指向安装后的Jar实际路径：

• 在类路径条目里使用Install4j变量，比如${installer:sys.installationDir}/your-app.jar，避免硬编码绝对路径
• 安装后查看安装目录，确认Jar文件确实存在，且路径和配置一致

验证测试 #

安装完成后，先在安装目录通过命令行执行java -jar your-app.jar --spring.profiles.active=staging确认应用能正常运行，再测试生成的EXE，排除应用本身的问题。

内容的提问来源于stack exchange，提问作者Paul