TestFX测试中FXMLLoader加载FXML文件返回空指针问题求助

以下是针对你遇到的FXML文件找不到问题的具体排查和解决步骤：

1. 确认FXML文件的编译输出位置 #

• 无论是Maven还是Gradle项目，资源文件（包括FXML）默认需要放在src/main/resources（主应用代码）或src/test/resources（测试代码）目录下，这样构建工具才会将其复制到编译后的target/classes或target/test-classes目录中（也就是classpath路径下）。
• 检查编译输出目录：如果target/classes/fxml/Home.fxml或target/test-classes/fxml/Home.fxml不存在，说明你的FXML文件没有被正确打包到classpath里，需要调整文件位置到resources目录下，或者修改构建配置。

2. 正确使用getResource路径 #

getResource的路径规则分两种：

• 相对路径：不带开头斜杠，比如"fxml/Home.fxml"，表示从当前类所在的包目录开始查找。例如你的测试类在com.example.tests包，那会找com/example/tests/fxml/Home.fxml。
• 绝对路径：带开头斜杠，比如"/fxml/Home.fxml"，表示从classpath的根目录开始查找，对应编译后的classes/fxml/Home.fxml位置。
• 如果你尝试用HelloApplication.class.getResource()，同样遵循上述规则：如果HelloApplication在com.example包，FXML在resources/fxml下，必须用绝对路径"/fxml/Home.fxml"；如果FXML在resources/com/example/fxml下，才能用相对路径"fxml/Home.fxml"。

3. 调整构建工具的资源配置（如果FXML不在resources目录） #

如果你的FXML文件必须放在src/main/java下的包目录中，需要修改构建工具配置，确保这些文件被复制到classpath：

Maven配置（pom.xml） #

<build>
    <resources>
        <!-- 包含src/main/java下的所有FXML文件 -->
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.fxml</include>
            </includes>
        </resource>
        <!-- 保留默认的resources目录配置 -->
        <resource>
            <directory>src/main/resources</directory>
        </resource>
    </resources>
</build>

Gradle配置（build.gradle） #

sourceSets {
    main {
        resources {
            // 添加src/main/java为资源目录，并包含FXML文件
            srcDirs += 'src/main/java'
            include '**/*.fxml'
        }
    }
}

4. 测试代码示例 #

假设FXML文件最终在classpath根目录的fxml文件夹下，测试代码中正确的加载方式：

// 使用绝对路径从classpath根查找
URL fxmlUrl = Objects.requireNonNull(getClass().getResource("/fxml/Home.fxml"));
FXMLLoader loader = new FXMLLoader(fxmlUrl);
Parent root = loader.load();

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