JavaFX报错NullPointerException: Location is required问题求助

问题背景 #

我开发的JavaFX应用全程在一个Stage中运行，Stage的Scene基于HBox构建，HBox包含两个AnchorPane分别显示控件与内容。应用启动时，Stage、Scene加载及控件渲染均正常，但点击按钮尝试将其中一个AnchorPane替换为另一个带独立控制器的FXML文件时，出现“Location is required”空指针异常。使用IntelliJ IDEA作为开发工具，相关代码和文件结构如下：

主方法代码 #

public class _Application extends javafx.application.Application
{
    @Override
    public void start(Stage stage) throws IOException
    {
        HBox root = new HBox();

        AnchorPane sidebar = FXMLLoader.load(Objects.requireNonNull(getClass().getResource("Sidebars/ReceptionistSidebar-View.fxml")));
        AnchorPane appointmentMain = FXMLLoader.load(Objects.requireNonNull(getClass().getResource("Receptionist/Appointments/NewAppointment-View.fxml")));

        root.getChildren().add(sidebar);
        root.getChildren().add(appointmentMain);
        Scene scene = new Scene(root);

        stage.setScene(scene);
        stage.show();
    }

    public static void main(String[] args)
    {
        launch();
    }
}

按钮事件代码 #

public class CreateNewPatientController
{
    @Override
    public void onCancel_ButtonClick() throws IOException
    {
        //Get the stage and scene
        Stage currentStage = (Stage) anchorPane_CreateNewPatient.getScene().getWindow();
        Scene a = currentStage.getScene();

        //Create a new HBox
        HBox root = new HBox();
    
        //Load the anchorpane FXML files
        AnchorPane sidebar = FXMLLoader.load(getClass().getClassLoader().getResource("Sidebars/ReceptionistSidebar-View.fxml"));
        AnchorPane appointmentMain = FXMLLoader.load(getClass().getClassLoader().getResource("Receptionist/CreateNewPatient-View.fxml"));

        //Add the containers to the root
        root.getChildren().add(sidebar);
        root.getChildren().add(appointmentMain);

        //set root to scene and stage
        Scene scene = new Scene(root);
        currentStage.setScene(scene);
    }
}

文件结构 #

• src根目录下包含：
  • Sidebars文件夹（内有ReceptionistSidebar-View.fxml）
  • Receptionist文件夹（内有CreateNewPatient-View.fxml，以及Appointments子文件夹，子文件夹内有NewAppointment-View.fxml）
  • 主类_Application和控制器类CreateNewPatientController

问题原因及解决方法 #

1. 资源路径加载错误（核心问题） #

主方法使用getClass().getResource()加载资源，按钮事件中却用了getClass().getClassLoader().getResource()，两者路径解析规则不同：

• getClass().getResource(path)：路径可相对当前类包路径，加/则表示类根目录的绝对路径
• getClass().getClassLoader().getResource(path)：路径必须是类根目录的相对路径，不能加/

修正按钮事件中的资源加载代码，统一使用getClass().getResource()并采用绝对路径：

// 修正后的资源加载代码
AnchorPane sidebar = FXMLLoader.load(Objects.requireNonNull(getClass().getResource("/Sidebars/ReceptionistSidebar-View.fxml")));
AnchorPane appointmentMain = FXMLLoader.load(Objects.requireNonNull(getClass().getResource("/Receptionist/CreateNewPatient-View.fxml")));

加Objects.requireNonNull()可快速定位资源不存在的问题，避免空指针异常。

2. 优化界面替换逻辑（可选） #

无需重新创建整个HBox和Scene，直接替换现有HBox的子节点即可提升性能：

public class CreateNewPatientController {
    @FXML
    private AnchorPane anchorPane_CreateNewPatient; // 确保FXML中已正确绑定该控件

    public void onCancel_ButtonClick() throws IOException {
        // 获取当前Scene的根节点（原HBox）
        HBox root = (HBox) anchorPane_CreateNewPatient.getScene().getRoot();
        
        // 加载新的内容面板
        AnchorPane appointmentMain = FXMLLoader.load(Objects.requireNonNull(getClass().getResource("/Receptionist/CreateNewPatient-View.fxml")));
        
        // 替换HBox中的第二个子节点（原内容面板）
        root.getChildren().set(1, appointmentMain);
    }
}

3. 检查IDEA资源配置 #

确保IDEA将FXML文件识别为资源：

• 右键FXML文件所在文件夹 → 选择"Mark Directory as" → "Resources Root"
• 或通过File → Project Structure → Modules，确认当前模块的Resources目录已正确配置

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