使用NetBeans构建的JavaFX Jar运行时报错：缺少JavaFX运行时组件

核心修复步骤 #

1. 运行Jar时必须指定模块路径和依赖模块 #

即使你使用了带JavaFX的Zulu JDK，直接执行java -jar your-app.jar仍会触发报错，因为Java不会自动加载JavaFX模块。需要在命令行中明确指定模块路径和所需模块：
假设你的lib目录和Jar文件在同一层级，运行命令示例：

java --module-path ./lib --add-modules javafx.controls,javafx.base,javafx.graphics -jar your-app.jar

根据你项目实际用到的JavaFX模块调整--add-modules后的内容，比如用到FXML就加上javafx.fxml

2. 检查Ant构建脚本的模块配置 #

确保你的Ant build.xml正确处理了JavaFX模块：

• 编译阶段要指定模块路径，打包Jar时要包含module-info.class文件
• 关键配置片段参考：

<!-- 编译任务 -->
<javac srcdir="src" destdir="build/classes">
    <modulepath>
        <fileset dir="lib" includes="*.jar"/>
    </modulepath>
</javac>

<!-- 打包Jar任务 -->
<jar destfile="dist/your-app.jar" basedir="build/classes">
    <manifest>
        <attribute name="Main-Class" value="你的主类全路径"/>
        <!-- 模块化项目需添加模块名称 -->
        <attribute name="Module" value="你的模块名"/>
    </manifest>
</jar>

3. 验证环境变量配置有效性 #

• 打开命令行执行java --version，确认输出显示Zulu FX JDK 17.0.6版本，确保JAVA_HOME指向的是正确的带FX的JDK
• 执行java --list-modules | findstr javafx，如果能列出javafx.controls、javafx.base等模块，说明JDK本身没问题；若没有，需重新检查JAVA_HOME配置并刷新环境变量

4. 确认lib目录Jar包完整性 #

• 确保lib目录下的JavaFX Jar包版本与Zulu JDK FX 17.0.6完全一致，禁止混用不同版本的JavaFX包
• 检查是否包含所有项目用到的模块对应的Jar，比如用到图形渲染就必须有javafx.graphics.jar，不能只保留base和controls

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