使用Ant构建JavaFX项目时遇模块未找到错误求助

问题原因 #

JavaFX 11及以上版本采用模块化架构，Ant的javac任务仅通过classpath引入JavaFX的jar包无法让编译器识别模块化依赖，必须通过modulepath指定模块路径才能正确解析javafx.controls、javafx.fxml等模块。此外，jfxrt.jar是JavaFX 8及更早版本的文件，JavaFX 19中已不存在，无需引入。

修复步骤 #

1. 移除无效的jfxrt.jar引用 #

在init-fx-tasks目标中，删除jfxrt.jar的文件引用：

<path id="fxant">
    <filelist>
        <file name="${java.home}\..\lib\ant-javafx.jar"/>
        <!-- 移除下面这行，JavaFX 19中无此文件 -->
        <!-- <file name="${java.home}\lib\jfxrt.jar"/> -->
    </filelist>
</path>

2. 修改javac任务的依赖配置 #

将javac任务中的classpath替换为modulepath，并删除jfxrt.jar的文件列表：

<javac includeantruntime="false" source="18" target="18" srcdir="build/src" destdir="build/classes" encoding="UTF-8">
    <!-- 用modulepath替代classpath -->
    <modulepath>
        <fileset dir="build/libs">
            <include name="javafx-swt.jar"/>
            <include name="javafx.fxml.jar"/>
            <include name="javafx.swing.jar"/>
            <include name="javafx.graphics.jar"/>
            <include name="javafx.base.jar"/>
            <include name="javafx.web.jar"/>
            <include name="javafx.controls.jar"/>
            <include name="javafx.media.jar"/>
        </fileset>
    </modulepath>
    <!-- 删除jfxrt.jar的引用 -->
    <!-- <filelist>
        <file name="C:\test\jdk-18.0.2.1\lib\jfxrt.jar"/>
    </filelist> -->
</javac>

3. 可选：简化Jar包复制步骤 #

setup-staging-area中多次复制单个Jar的操作可以简化为一次复制所有需要的Jar：

<copy todir="externalLibs">
    <fileset dir="C:\test\javafx-sdk-19\lib">
        <include name="javafx.controls.jar"/>
        <include name="javafx.swing.jar"/>
        <include name="javafx.base.jar"/>
        <include name="javafx-swt.jar"/>
        <include name="javafx.graphics.jar"/>
        <include name="javafx.media.jar"/>
        <include name="javafx.web.jar"/>
        <include name="javafx.fxml.jar"/>
    </fileset>
</copy>

验证修改 #

重新执行Ant构建命令，编译器将通过modulepath正确识别JavaFX模块，解决module not found的错误。

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