Java 10环境下JavaFX程序安装后EXE无法正常运行求助

我之前升级JavaFX版本时也碰到过一模一样的闪退坑，这类问题基本都和Java 9之后引入的模块化机制脱不了干系——毕竟Java 8用的是类路径，到了Java 10必须切换到模块路径逻辑，稍有配置遗漏就会直接崩。下面是几个亲测有效的排查和解决方向：

1. 先把Maven的JavaFX插件配置拉满 #

Java 10下JavaFX是独立模块化的，你的pom.xml里javafx-maven-plugin必须明确指定模块相关参数，不然打包出来的程序根本找不到核心模块：

• 主类要写成模块名+全类名的格式，比如com.myapp.demo/com.myapp.demo.MainApp
• 必须通过--add-modules声明你用到的JavaFX模块（比如javafx.controls、javafx.fxml）
  示例配置如下：

<plugin>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-maven-plugin</artifactId>
    <version>0.0.8</version>
    <configuration>
        <mainClass>com.myapp.demo/com.myapp.demo.MainApp</mainClass>
        <options>
            <option>--add-modules</option>
            <option>javafx.controls,javafx.fxml</option>
        </options>
    </configuration>
</plugin>

2. 别让用户自己装JavaFX！打包时带上运行时 #

Java 8之后JavaFX就不再捆绑在JDK/JRE里了，如果你用的是普通OpenJDK/Oracle JDK，默认不带JavaFX模块。解决办法有两个：

• 用jlink工具打包一个包含JavaFX模块的自定义JRE，然后让Inno Setup指向这个JRE的java.exe启动程序
• 把JavaFX的模块JAR（比如javafx-controls-10.0.2-win.jar这类）和你的程序一起打包，在启动命令里指定模块路径

3. 强制看报错日志，别光盯着闪退 #

闪退最烦的就是看不到错误信息，直接用命令行启动EXE就能抓日志：

• 打开命令提示符，找到安装后的EXE所在目录，直接输入EXE文件名回车，控制台会输出具体的错误（比如找不到模块javafx.controls或者类缺失）
• 如果是用javapackager生成的EXE，还可以去用户目录或者安装目录的logs文件夹里找自动生成的崩溃日志

4. 把Inno Setup的启动命令改成模块化格式 #

很多人升级后忘了改Inno Setup里的启动脚本，还在用Java 8的-jar写法，这肯定会崩。把启动命令改成适配模块的格式：
原来的旧命令（Java 8风格）：

"{app}\jre\bin\java.exe" -jar "{app}\myapp.jar"

改成新的模块化命令：

"{app}\jre\bin\java.exe" --module-path "{app}\lib" --add-modules javafx.controls,javafx.fxml -m com.myapp.demo/com.myapp.demo.MainApp

这里的{app}\lib要包含所有JavaFX模块JAR和你的程序依赖JAR。

5. 确认Maven打包时没丢依赖 #

用mvn dependency:copy-dependencies命令把所有依赖（包括JavaFX模块）复制到指定目录，再检查Inno Setup的打包脚本是否把这些文件都包含进去了——别漏了某个核心模块，不然运行时照样找不到类。

我当时就是因为没在javafx-maven-plugin里加--add-modules参数，导致打包出来的程序找不到JavaFX核心模块，改完配置和启动命令就正常运行了。

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