JavaFX项目运行报错javafx.fxml.LoadException求解

以下是针对javafx.fxml.LoadException（无法找到控制器类）的常见排查和解决步骤：

• 检查FXML文件的控制器配置

  确保FXML根节点的fx:controller属性填写的是PainterController的完整全类名，包含包路径。例如控制器在com.demo.painter包下，属性值应为fx:controller="com.demo.painter.PainterController"，不能只写PainterController。

• 验证包结构与类路径匹配
  确认PainterController.java文件的实际包目录和FXML中声明的包名完全一致，注意Java包名区分大小写，避免因大小写不匹配导致加载失败。

• 修正FXMLLoader的资源加载路径
  加载FXML时需使用正确的类路径资源路径，示例代码如下：

  FXMLLoader loader = new FXMLLoader(getClass().getResource("/com/demo/painter/Painter.fxml"));
  Parent root = loader.load();
  

  路径开头的/表示从类路径根目录开始查找，确保FXML文件在编译后被正确复制到类路径目录中。

• 确认控制器类已成功编译
  检查项目编译输出目录（如Maven的target/classes或Gradle的build/classes/java/main），确认存在PainterController.class文件。若不存在，重新编译项目，排查是否有编译错误导致类未生成。

• 模块化项目的额外配置
  如果项目使用Java模块系统，需在module-info.java中添加以下配置：

  module your.module.name {
      requires javafx.fxml;
      // 导出控制器所在包
      exports com.demo.painter;
      // 开放包给javafx.fxml以反射访问控制器
      opens com.demo.painter to javafx.fxml;
  }
  

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