1. 为什么需要将SpringBoot项目打包成exe很多Java开发者都有这样的困惑明明已经用SpringBoot开发好了应用为什么还要多此一举打包成exe其实这个问题就像问为什么要把源代码编译成可执行文件一样。想象一下如果你要给客户演示一个管理系统难道要对方先安装JDK、配置环境变量再用命令行启动吗这显然不够专业。我在实际项目中就遇到过这样的尴尬场景。去年给一家连锁超市开发库存系统时店长看着黑乎乎的cmd窗口直皱眉头小张啊你们这个系统怎么跟黑客电影似的从那以后我就养成了把SpringBoot项目打包成exe安装包的习惯。这样做有几个实实在在的好处降低使用门槛用户双击就能运行完全不需要懂Java环境配置保护代码安全相比直接分发jar包exe更难被反编译提升专业度安装向导、桌面图标、开始菜单这些细节让软件看起来更正规便于分发一个安装包搞定所有依赖连JRE都可以打包进去不过要注意的是exe打包并不是银弹。如果是需要频繁更新的微服务还是建议用传统jar包部署。但对于客户端应用、演示系统、工具类软件exe绝对是更好的选择。2. 准备工作从SpringBoot到可执行jar2.1 两种打包方式对比在IDEA中把SpringBoot项目打包成jar看似简单实则暗藏玄机。关键问题在于如何处理第三方依赖。我踩过好几次坑之后总结出两种主流方案方案一使用maven-assembly-plugin打包推荐这是最优雅的解决方案只需要在pom.xml中添加如下配置build plugins plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-assembly-plugin/artifactId version3.3.0/version configuration descriptorRefs descriptorRefjar-with-dependencies/descriptorRef /descriptorRefs archive manifest mainClasscom.example.Application/mainClass /manifest /archive /configuration executions execution phasepackage/phase goals goalsingle/goal /goals /execution /executions /plugin /plugins /build执行mvn clean package后target目录会生成两个jaryour-project-1.0.jar普通jar包your-project-1.0-jar-with-dependencies.jar包含所有依赖的fat jar方案二手动配置Artifacts如果maven插件方式不奏效有时候SpringBoot项目会有这个问题可以尝试IDEA自带的打包功能打开Project Structure (CtrlAltShiftS)选择Artifacts → → JAR → From modules with dependencies选择Main Class后一定要选择copy to the output directory and link via manifest将右侧的依赖项全部移到左边点击Build → Build Artifacts生成jar包提示如果遇到找不到主类错误检查MANIFEST.MF文件中Main-Class和Class-Path配置是否正确2.2 常见问题排查在实际操作中我遇到过几个典型问题依赖冲突特别是当项目同时引入不同版本的Spring组件时。建议先用mvn dependency:tree检查依赖树资源文件丢失static和templates目录下的文件没被打包。确保pom.xml中配置了resources启动报错No main manifest attribute说明MANIFEST.MF中没指定Main-Class检查打包配置3. 使用exe4j将jar转为exe3.1 exe4j基础配置exe4j是目前最成熟的Java转exe工具虽然收费但有免费试用版。安装后按照向导操作选择JAR in EXE模式填写应用信息时输出目录建议选择空文件夹后续所有依赖都放在这里在Java invocation配置页添加主jar包设置main class可以点击Search自动查找在Classpath中添加所有依赖jar支持拖拽这里有个小技巧如果用了方案一的fat jar只需要添加一个jar-with-dependencies.jar如果用方案二需要添加主jar和所有依赖jar。3.2 打包JRE的注意事项要让exe在没有Java环境的电脑上运行必须打包JRE从官网下载对应版本的JRE建议用1.8或11这些LTS版本解压到exe输出目录的jre子文件夹在exe4j的JRE配置页设置Min/Max版本选择Bundled JRE并指定jre路径勾选Search sequence确保会fallback到系统JRE注意JRE目录名不要带空格和中文否则可能找不到3.3 高级配置技巧经过多个项目实践我总结出几个实用配置内存设置在VM parameters中添加-Xmx512m -Xms256m控制内存使用启动画面可以配置splash image让启动更美观日志输出建议开启日志并设置滚动策略方便排查问题32/64位兼容如果打包32位exe必须用32位JRE配置完成后点击Build EXE就能生成可执行文件。建议先在本机测试再复制到其他机器验证兼容性。4. 使用Inno Setup制作安装包4.1 基础安装包配置Inno Setup是免费的安装包制作工具比NSIS更简单易用。基本流程新建脚本向导填写应用信息名称、版本、出版商等指定exe文件位置和输出目录设置开始菜单文件夹和桌面图标配置安装模式典型/自定义/完全关键步骤是在[Files]段添加所有需要打包的文件[Files] Source: D:\output\*.exe; DestDir: {app}; Flags: ignoreversion Source: D:\output\lib\*; DestDir: {app}\lib; Flags: ignoreversion recursesubdirs Source: D:\output\jre\*; DestDir: {app}\jre; Flags: ignoreversion recursesubdirs4.2 打包JRE的最佳实践为了让安装包更专业建议在[Setup]段定义JRE变量#define JreDir jre1.8.0_301添加环境变量检测[Code] function InitializeSetup(): Boolean; begin if not RegQueryStringValue(HKLM, SOFTWARE\JavaSoft\Java Runtime Environment, CurrentVersion, JavaVersion) then begin MsgBox(未检测到Java环境将使用内置JRE, mbInformation, MB_OK); end; Result : True; end;添加安装后检查[Run] Filename: {app}\MyApp.exe; Description: 启动应用; Flags: postinstall nowait4.3 提升用户体验的技巧多语言支持Inno Setup支持中文安装界面安装前检测可以检查是否安装了VC运行库等依赖自定义界面通过修改脚本可以美化安装界面静默安装添加/SILENT参数支持后台安装编译脚本后会生成两个文件MyAppSetup.exe常规安装包MyAppSetup.exe /PORTABLE1绿色版5. 常见问题与解决方案5.1 依赖问题排查在多个Windows机器上测试时可能会遇到缺少dll安装VC运行库或手动放置dll到jre/bin目录字体显示异常打包时包含项目用到的字体文件中文乱码确保JRE和系统编码一致建议都用UTF-85.2 性能优化建议使用jlink裁剪JRE只保留需要的模块对资源文件进行压缩考虑使用GraalVM native-image生成更轻量的exe5.3 安全注意事项不要将敏感信息如数据库密码硬编码在代码中考虑使用代码混淆工具保护业务逻辑对安装包进行数字签名提升可信度经过完整打包流程后你的SpringBoot应用就变成了一个专业的Windows软件。记得在不同版本的Windows上测试兼容性特别是Win7和Win10可能会有差异。
SpringBoot项目一键打包exe与安装包实战指南
发布时间：2026/6/9 5:10:23
1. 为什么需要将SpringBoot项目打包成exe很多Java开发者都有这样的困惑明明已经用SpringBoot开发好了应用为什么还要多此一举打包成exe其实这个问题就像问为什么要把源代码编译成可执行文件一样。想象一下如果你要给客户演示一个管理系统难道要对方先安装JDK、配置环境变量再用命令行启动吗这显然不够专业。我在实际项目中就遇到过这样的尴尬场景。去年给一家连锁超市开发库存系统时店长看着黑乎乎的cmd窗口直皱眉头小张啊你们这个系统怎么跟黑客电影似的从那以后我就养成了把SpringBoot项目打包成exe安装包的习惯。这样做有几个实实在在的好处降低使用门槛用户双击就能运行完全不需要懂Java环境配置保护代码安全相比直接分发jar包exe更难被反编译提升专业度安装向导、桌面图标、开始菜单这些细节让软件看起来更正规便于分发一个安装包搞定所有依赖连JRE都可以打包进去不过要注意的是exe打包并不是银弹。如果是需要频繁更新的微服务还是建议用传统jar包部署。但对于客户端应用、演示系统、工具类软件exe绝对是更好的选择。2. 准备工作从SpringBoot到可执行jar2.1 两种打包方式对比在IDEA中把SpringBoot项目打包成jar看似简单实则暗藏玄机。关键问题在于如何处理第三方依赖。我踩过好几次坑之后总结出两种主流方案方案一使用maven-assembly-plugin打包推荐这是最优雅的解决方案只需要在pom.xml中添加如下配置build plugins plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-assembly-plugin/artifactId version3.3.0/version configuration descriptorRefs descriptorRefjar-with-dependencies/descriptorRef /descriptorRefs archive manifest mainClasscom.example.Application/mainClass /manifest /archive /configuration executions execution phasepackage/phase goals goalsingle/goal /goals /execution /executions /plugin /plugins /build执行mvn clean package后target目录会生成两个jaryour-project-1.0.jar普通jar包your-project-1.0-jar-with-dependencies.jar包含所有依赖的fat jar方案二手动配置Artifacts如果maven插件方式不奏效有时候SpringBoot项目会有这个问题可以尝试IDEA自带的打包功能打开Project Structure (CtrlAltShiftS)选择Artifacts → → JAR → From modules with dependencies选择Main Class后一定要选择copy to the output directory and link via manifest将右侧的依赖项全部移到左边点击Build → Build Artifacts生成jar包提示如果遇到找不到主类错误检查MANIFEST.MF文件中Main-Class和Class-Path配置是否正确2.2 常见问题排查在实际操作中我遇到过几个典型问题依赖冲突特别是当项目同时引入不同版本的Spring组件时。建议先用mvn dependency:tree检查依赖树资源文件丢失static和templates目录下的文件没被打包。确保pom.xml中配置了resources启动报错No main manifest attribute说明MANIFEST.MF中没指定Main-Class检查打包配置3. 使用exe4j将jar转为exe3.1 exe4j基础配置exe4j是目前最成熟的Java转exe工具虽然收费但有免费试用版。安装后按照向导操作选择JAR in EXE模式填写应用信息时输出目录建议选择空文件夹后续所有依赖都放在这里在Java invocation配置页添加主jar包设置main class可以点击Search自动查找在Classpath中添加所有依赖jar支持拖拽这里有个小技巧如果用了方案一的fat jar只需要添加一个jar-with-dependencies.jar如果用方案二需要添加主jar和所有依赖jar。3.2 打包JRE的注意事项要让exe在没有Java环境的电脑上运行必须打包JRE从官网下载对应版本的JRE建议用1.8或11这些LTS版本解压到exe输出目录的jre子文件夹在exe4j的JRE配置页设置Min/Max版本选择Bundled JRE并指定jre路径勾选Search sequence确保会fallback到系统JRE注意JRE目录名不要带空格和中文否则可能找不到3.3 高级配置技巧经过多个项目实践我总结出几个实用配置内存设置在VM parameters中添加-Xmx512m -Xms256m控制内存使用启动画面可以配置splash image让启动更美观日志输出建议开启日志并设置滚动策略方便排查问题32/64位兼容如果打包32位exe必须用32位JRE配置完成后点击Build EXE就能生成可执行文件。建议先在本机测试再复制到其他机器验证兼容性。4. 使用Inno Setup制作安装包4.1 基础安装包配置Inno Setup是免费的安装包制作工具比NSIS更简单易用。基本流程新建脚本向导填写应用信息名称、版本、出版商等指定exe文件位置和输出目录设置开始菜单文件夹和桌面图标配置安装模式典型/自定义/完全关键步骤是在[Files]段添加所有需要打包的文件[Files] Source: D:\output\*.exe; DestDir: {app}; Flags: ignoreversion Source: D:\output\lib\*; DestDir: {app}\lib; Flags: ignoreversion recursesubdirs Source: D:\output\jre\*; DestDir: {app}\jre; Flags: ignoreversion recursesubdirs4.2 打包JRE的最佳实践为了让安装包更专业建议在[Setup]段定义JRE变量#define JreDir jre1.8.0_301添加环境变量检测[Code] function InitializeSetup(): Boolean; begin if not RegQueryStringValue(HKLM, SOFTWARE\JavaSoft\Java Runtime Environment, CurrentVersion, JavaVersion) then begin MsgBox(未检测到Java环境将使用内置JRE, mbInformation, MB_OK); end; Result : True; end;添加安装后检查[Run] Filename: {app}\MyApp.exe; Description: 启动应用; Flags: postinstall nowait4.3 提升用户体验的技巧多语言支持Inno Setup支持中文安装界面安装前检测可以检查是否安装了VC运行库等依赖自定义界面通过修改脚本可以美化安装界面静默安装添加/SILENT参数支持后台安装编译脚本后会生成两个文件MyAppSetup.exe常规安装包MyAppSetup.exe /PORTABLE1绿色版5. 常见问题与解决方案5.1 依赖问题排查在多个Windows机器上测试时可能会遇到缺少dll安装VC运行库或手动放置dll到jre/bin目录字体显示异常打包时包含项目用到的字体文件中文乱码确保JRE和系统编码一致建议都用UTF-85.2 性能优化建议使用jlink裁剪JRE只保留需要的模块对资源文件进行压缩考虑使用GraalVM native-image生成更轻量的exe5.3 安全注意事项不要将敏感信息如数据库密码硬编码在代码中考虑使用代码混淆工具保护业务逻辑对安装包进行数字签名提升可信度经过完整打包流程后你的SpringBoot应用就变成了一个专业的Windows软件。记得在不同版本的Windows上测试兼容性特别是Win7和Win10可能会有差异。
