SpringBoot3+JavaFX21打包Windows EXE完整指南-代码聚汇网

SpringBoot3+JavaFX21打包Windows EXE完整指南

李祥JasonLee·2026-08-25·阅读 23 GEO检测（免费）

JavaFXSpringBootJPackage

|难度：普通|阅读约 14 分钟

1. 项目概述

最近在开发一个桌面应用项目时，遇到了一个典型的技术挑战：如何将基于SpringBoot3、JDK17和JavaFX21的Java应用打包成Windows平台的可执行EXE文件。这个需求在金融、医疗等行业应用中非常常见，特别是当我们需要交付给非技术背景的客户使用时，一个双击就能运行的EXE显然比一堆JAR文件更友好。

经过几轮技术调研和实际测试，我总结出了一套完整的解决方案。这套方案不仅解决了基础打包问题，还处理了JavaFX的模块化依赖、运行时资源加载等常见痛点。下面我就把整个实现过程详细分享出来，包括踩过的坑和优化技巧。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 环境准备与工具选型

2.1 基础环境配置

首先确保你的开发环境满足以下要求：

JDK 17（建议使用Azul Zulu或Oracle官方版本）
Maven 3.8+（用于依赖管理）
IntelliJ IDEA 2023+（社区版即可）

注意：JavaFX从JDK11开始不再随JDK一起发布，需要单独引入依赖。这也是为什么我们需要特别关注JavaFX21的集成方式。

2.2 打包工具对比

我们主要评估了三种EXE打包方案：

工具名称	优点	缺点	适用场景
Launch4j	配置简单，轻量级	需要额外提供JRE	小型应用
JPackage	JDK内置工具，官方支持	配置复杂，模块化要求严格	需要官方打包的场景
Inno Setup	可制作安装包，功能强大	学习曲线陡峭	需要安装向导的复杂应用

最终选择了JPackage作为核心打包工具，主要基于以下考虑：

它是JDK14+官方提供的打包工具
支持自动处理模块化依赖
生成的EXE可以直接绑定JRE

3. 项目配置关键步骤

3.1 Maven依赖配置

首先在pom.xml中添加必要的依赖：

xml复制<properties>
    <javafx.version>21</javafx.version>
</properties>

<dependencies>
    <!-- Spring Boot Starter -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
        <version>3.1.0</version>
    </dependency>

    <!-- JavaFX依赖（注意scope为compile） -->
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-controls</artifactId>
        <version>${javafx.version}</version>
    </dependency>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-fxml</artifactId>
        <version>${javafx.version}</version>
    </dependency>
</dependencies>

3.2 模块化配置

由于JavaFX21强制要求模块化，需要在src/main/java下添加module-info.java：

java复制module com.example.myapp {
    requires javafx.controls;
    requires javafx.fxml;
    requires spring.boot;
    requires spring.boot.autoconfigure;
    
    opens com.example.myapp to spring.core, javafx.fxml;
    exports com.example.myapp;
}

3.3 主类改造

SpringBoot应用的主类需要继承Application并实现start方法：

java复制public class MainApplication extends Application {
    private ConfigurableApplicationContext springContext;

    @Override
    public void init() {
        springContext = SpringApplication.run(SpringConfig.class);
    }

    @Override
    public void start(Stage primaryStage) {
        springContext.publishEvent(new StageReadyEvent(primaryStage));
    }

    @Override
    public void stop() {
        springContext.close();
    }
}

4. 打包实战过程

4.1 使用jlink创建自定义JRE

先创建一个只包含必要模块的轻量级JRE：

bash复制jlink --module-path %JAVA_HOME%\jmods --add-modules java.base,java.desktop,javafx.controls,javafx.fxml --output target/jre

4.2 JPackage打包命令

完整的打包命令如下：

bash复制jpackage --name MyApp \
         --module-path target/modules \
         --module com.example.myapp/com.example.myapp.MainApplication \
         --runtime-image target/jre \
         --dest target/dist \
         --win-shortcut \
         --win-menu \
         --type exe \
         --icon src/main/resources/icon.ico

4.3 处理资源文件

对于SpringBoot的静态资源（如application.properties），需要特殊处理：

在pom.xml中配置资源过滤：

xml复制<resources>
    <resource>
        <directory>src/main/resources</directory>
        <filtering>true</filtering>
    </resource>
</resources>

修改资源加载方式：

java复制@Bean
public ResourcePatternResolver resourcePatternResolver() {
    return new PathMatchingResourcePatternResolver() {
        @Override
        protected Resource resolveRootDirResource(Resource original) throws IOException {
            // 处理打包后的资源路径问题
            if (original.getURL().toString().startsWith("jar:")) {
                return original;
            }
            return super.resolveRootDirResource(original);
        }
    };
}

5. 常见问题与解决方案

5.1 模块路径问题

症状：运行时报错"Module not found"

解决方案：

确保module-info.java正确定义了所有required模块
使用jdeps分析依赖：

bash复制jdeps --list-deps target/myapp.jar

5.2 JavaFX与Spring冲突

症状：JavaFX窗口显示后Spring上下文未初始化

修复方案：

java复制public class StageReadyEvent extends ApplicationEvent {
    public final Stage stage;
    
    public StageReadyEvent(Stage stage) {
        super(stage);
        this.stage = stage;
    }
}

@Configuration
public class SpringConfig {
    @EventListener
    public void handleStageReady(StageReadyEvent event) {
        // 在这里初始化JavaFX界面
    }
}

5.3 内存设置优化

在打包时指定JVM参数：

bash复制jpackage ... --java-options "-Xms256m" --java-options "-Xmx1024m"

6. 高级优化技巧

6.1 减小包体积

使用ProGuard进行代码混淆：

xml复制<plugin>
    <groupId>com.github.wvengen</groupId>
    <artifactId>proguard-maven-plugin</artifactId>
    <version>2.6.0</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>proguard</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <obfuscate>true</obfuscate>
        <injar>${project.build.finalName}.jar</injar>
    </configuration>
</plugin>

选择性地包含JRE模块：

bash复制jlink --compress=2 --no-header-files --no-man-pages ...

6.2 自动更新机制

可以通过SpringBoot Actuator实现简单的更新检查：

java复制@RestController
@RequestMapping("/api/update")
public class UpdateController {
    
    @GetMapping("/check")
    public ResponseEntity<UpdateInfo> checkUpdate(
            @RequestParam String currentVersion) {
        // 实现版本检查逻辑
    }
}

然后在JavaFX中定期调用该接口：

java复制Timer timer = new Timer();
timer.schedule(new TimerTask() {
    @Override
    public void run() {
        Platform.runLater(() -> {
            // 调用更新检查
        });
    }
}, 0, 24 * 60 * 60 * 1000); // 每天检查一次

7. 实际部署建议

签名证书：建议购买代码签名证书（如DigiCert），避免Windows SmartScreen拦截

bash复制jpackage ... --win-upgrade-uuid "YOUR-UUID" --win-per-user-install

安装位置：考虑用户权限问题

bash复制--install-dir "AppData/Local/MyCompany/MyApp"

properties复制logging.file.path=${user.home}/.myapp/logs

这套方案已经在多个生产项目中验证，打包后的EXE文件平均大小在60-80MB（包含JRE），启动时间在2-3秒左右。对于需要频繁更新的场景，建议将核心业务逻辑做成独立JAR，通过类加载器动态加载。