JPackage打包JavaFX+Spring Boot应用生成msi安装后无法启动如何解决

问题定位方法 #

你可以通过重定向javaw运行日志的方式获取无控制台模式下的报错信息，步骤如下：

1. 安装生成的msi包后，进入软件的安装目录（默认路径为C:\Program Files\mytest）
2. 在目录空白处按住Shift+右键，选择「在此处打开PowerShell窗口」或「在此处打开命令提示符」
3. 执行以下命令，将运行时输出重定向到日志文件：

.\runtime\bin\javaw.exe -jar mytest-1.0.jar > run.log 2>&1

4. 等待3-5秒后打开生成的run.log文件，即可看到具体的异常栈信息，定位根因。

常见修复方案 #

根据你添加--win-console参数即可正常运行的现象，大概率是以下两个问题导致：

1. Spring Boot默认开启的AWT无头模式冲突JavaFX渲染 #

Spring Boot启动时默认会将java.awt.headless参数设为true，该配置会禁止AWT相关的GUI渲染能力，和JavaFX运行冲突。
修复方式：修改Main启动类，在Spring上下文初始化前关闭无头模式即可：

public class Main extends Application {
    // 省略其他代码
    public static void main(String[] args) {
        // 关闭无头模式
        System.setProperty("java.awt.headless", "false");
        Application.launch(args);
    }

    public void init() throws  Exception{
        // 也可以在启动Spring Boot时传入参数关闭
        springContext = SpringApplication.run(Main.class, "--spring.main.headless=false");
    }
}

2. 非模块化项目未显式指定加载JavaFX模块 #

你在jlink阶段已经把JavaFX模块打入了自定义运行时，但非模块化项目启动时JVM默认不会自动加载这些模块，javafx:run命令运行时插件会自动添加该参数，手动调用jpackage时缺失该配置就会导致类加载失败。
修复方式：修改构建脚本中的jpackage命令，添加--java-options参数显式指定加载JavaFX模块：

jpackage --type msi --dest target/installer --input target --name mytest --main-class org.test.Main --main-jar mytest-1.0.jar --runtime-image target/java-runtime --java-options "--add-modules javafx.controls,javafx.graphics,javafx.fxml"

可选：修正Spring Boot打包主类配置 #

spring-boot-maven-plugin默认会把可执行jar的启动主类替换为Spring Boot自带的JarLauncher，如果你的jar包中META-INF/MANIFEST.MF的Main-Class属性不是org.test.Main，需要在pom中显式指定主类：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <version>2.6.0</version>
    <configuration>
        <mainClass>org.test.Main</mainClass>
    </configuration>
</plugin>

完成以上修改后重新运行构建脚本打包，安装后不需要加--win-console参数即可正常启动GUI界面。

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