Eclipse中JavaFX项目配置module-info启动及FXML加载异常求助

1. 模块访问异常修复（javafx.fxml无法访问自定义控制器类） #

该问题由Java 9+模块系统的跨包访问限制导致：javafx.fxml需要通过反射实例化你的控制器类，默认没有权限访问自定义模块下的非公开包。

正确module-info.java配置示例： #

module HLC {
    // 依赖核心JavaFX模块
    requires javafx.controls;
    requires javafx.fxml;
    requires javafx.graphics;

    // 开放控制器所在包给javafx.fxml，允许反射访问
    opens VideoClub.controllers to javafx.fxml;
    // 导出控制器包，供内部模块调用
    exports VideoClub.controllers;
}

无模块模式运行失效的问题，是Eclipse运行配置缓存导致：清理原有运行配置，删除module-info.java后，在运行配置的VM参数里添加--add-modules javafx.controls,javafx.fxml,javafx.graphics即可稳定运行无模块模式。

2. "Location is required"空指针异常修复 #

该报错的核心原因是FXMLLoader加载FXML时传入的资源路径错误，无法定位到对应FXML文件。

正确加载代码示例： #

假设你的项目结构如下：

src
├── VideoClub
│   ├── controllers
│   │   └── InicioController.java
│   └── Launcher.java
└── resources
    └── fxml
        └── inicio.fxml
        └── targetPage.fxml

页面跳转方法写法：

@FXML
private void jumpToPage(ActionEvent event) throws IOException {
    // 路径开头加/代表从资源根目录查找，避免相对路径错位
    URL fxmlUrl = getClass().getResource("/fxml/targetPage.fxml");
    // 提前判空，方便排查路径错误
    if (fxmlUrl == null) {
        throw new RuntimeException("FXML文件不存在，请检查路径：/fxml/targetPage.fxml");
    }
    Parent root = FXMLLoader.load(fxmlUrl);
    Stage currentStage = (Stage) ((Node) event.getSource()).getScene().getWindow();
    currentStage.setScene(new Scene(root));
    currentStage.show();
}

常见错误排查点： #

• 确认resources目录被Eclipse标记为资源根：右键项目→Build Path→Configure Build Path→Source选项卡，确保resources目录是Source Folder，没有被Exclude
• FXML文件名大小写和路径完全匹配：Windows系统大小写不敏感，重启后缓存失效就会触发找不到文件的问题
• 不要直接写相对路径（如getResource("targetPage.fxml")），除非FXML文件和当前控制器类在同一个包目录下

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