JavaFX嵌入式Derby图书管理系统通过Launch4j生成EXE后运行报错的解决方案咨询

首先得明确几个核心问题：为什么打包后会报JavaFX组件缺失，代码里能不能加JVM参数，以及如何正确配置发布流程。

1. 为什么会出现「JavaFX runtime components are missing」错误？ #

从JDK 11开始，JavaFX不再是JDK的默认组件，属于独立的模块。你在IDE里运行正常，是因为IDE已经帮你配置了JavaFX的模块路径和依赖，但打包成Jar/EXE时，如果没有把JavaFX runtime一起打包，或者启动时没指定正确的模块参数，JVM就找不到JavaFX的核心类，自然报错。

2. 能不能在代码中添加JVM选项？ #

不行。JVM参数是在程序启动前就需要加载的，等你的Java代码开始运行时，JVM已经初始化完成了，这时再修改参数根本不起作用。所以必须在启动环节（比如Launch4j配置、打包脚本里）指定参数。

3. 更可靠的发布带有嵌入式Derby的JavaFX程序的方式 #

推荐两种主流方案，都能避免手动配置的麻烦：

方案一：用JavaFX官方插件打包成自包含镜像（推荐） #

不管你用Maven还是Gradle，都可以用官方的JavaFX插件直接生成包含JRE、JavaFX runtime、你的程序和Derby数据库的自包含包，甚至直接生成对应平台的可执行文件（Windows下就是EXE），不需要用户额外安装JDK/JRE。

Maven配置示例：

在pom.xml里添加javafx-maven-plugin：

<plugin>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-maven-plugin</artifactId>
    <version>0.0.8</version>
    <configuration>
        <!-- 你的主类，模块化项目要加模块名，格式：模块名/主类全路径 -->
        <mainClass>你的主类全路径</mainClass>
        <!-- 指定打包平台，Windows对应win -->
        <platforms>
            <platform>win</platform>
        </platforms>
    </configuration>
</plugin>

然后运行命令：

mvn clean javafx:jlink

执行完成后，在target/image目录下会生成完整的运行环境，bin目录里的启动程序就是Windows可执行EXE，直接运行即可。Derby的Jar只要在项目依赖中，插件会自动包含进去。

方案二：自定义JRE + Launch4j打包 #

如果还是想用Launch4j，可以先通过jlink生成包含JavaFX和项目依赖的自定义JRE，再用Launch4j指向这个JRE：

1. 确保项目是模块化的（存在module-info.java），声明所需模块：

module com.example.bookmanager {
    requires javafx.controls;
    requires javafx.fxml;
    // 嵌入式Derby的依赖，根据实际Jar调整
    requires org.apache.derby.jdbc;
    // 如果FXML需要访问控制器包，开放权限
    opens com.example.bookmanager.controller to javafx.fxml;
    // 导出主类所在包（按需配置）
    exports com.example.bookmanager;
}

2. 用jlink生成自定义JRE：

jlink --module-path "path/to/javafx/lib;target/classes" --add-modules com.example.bookmanager --output target/custom-jre

3. 在Launch4j中配置：
   • 切换到「JRE」选项卡，设置「Min JRE version」为你的JDK版本，然后指定「Runtime directory」为刚才生成的custom-jre目录。
   • 无需额外添加--module-path和--add-modules参数，因为自定义JRE已经包含所有必需模块。

4. 解决子包访问错误的配置 #

如果加了JVM参数后出现子包无法访问的问题，大概率是模块权限配置不当：

• 若你的代码子包需要被JavaFX（比如FXML）访问，在module-info.java中添加opens 你的子包路径 to javafx.fxml;，例如opens com.example.bookmanager.models to javafx.fxml;。
• 若需要访问Derby的子包，检查Derby的模块声明，确保在module-info.java中添加requires transitive org.apache.derby;（如果Derby依赖其他子模块），或者直接指定具体子模块如requires org.apache.derby.tools;。
• 若项目是非模块化的（无module-info.java），可在JVM参数中添加--add-opens开放模块访问，例如--add-opens javafx.base/com.sun.javafx.runtime=ALL-UNNAMED（根据实际报错包调整），但更推荐转为模块化项目，从根源避免权限问题。

最后提醒：打包时务必将Derby相关Jar（如derby.jar、derbytools.jar）包含到发布包中，确保程序能找到嵌入式数据库的驱动类。

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