JavaFX项目分包后运行报错问题求助

问题描述 #

Eclipse里的JavaFX项目，默认结构下运行完全正常。想重构包结构：把控制器类和Main类拆分到不同包，FXML文件单独放在一个专属包中。调整后运行先抛出java.lang.NullPointerException: Location is required.错误，尝试修改FXML加载路径为../Sample.fxml后，又出现javafx.fxml.LoadException，底层原因是java.lang.ClassNotFoundException: application.SampleController。

解决步骤 #

1. 用类路径绝对路径加载FXML #

不要使用../这类相对路径，JavaFX加载FXML必须基于类路径绝对路径，避免当前类所在包的影响：
假设你的最终包结构为：

src/
├─ application/
│  ├─ classes/
│  │  └─ Main.java
│  ├─ controllers/
│  │  └─ SampleController.java
│  └─ guifiles/
│     └─ Sample.fxml

将Main类中的加载代码修改为：

AnchorPane root = (AnchorPane) FXMLLoader.load(getClass().getResource("/application/guifiles/Sample.fxml"));

或者使用系统类加载器，兼容性更强：

AnchorPane root = (AnchorPane) FXMLLoader.load(ClassLoader.getSystemResource("application/guifiles/Sample.fxml"));

2. 修正FXML文件中的控制器全类名 #

打开FXML文件，找到第5行的fx:controller属性，必须填写控制器类的完整包路径。比如控制器已移至application.controllers包，就改成：

fx:controller="application.controllers.SampleController"

之前的报错就是因为FXML中仍保留旧的application.SampleController路径，找不到已迁移的控制器类。

3. 确保Eclipse正确编译资源文件 #

右键项目 → 属性 → Java Build Path → 源代码，确认src/application/guifiles所在的源文件夹被勾选，这样Eclipse编译时才会自动将FXML文件复制到bin目录对应的包路径下，保证运行时能被正确找到。

验证步骤 #

编译完成后，前往项目的bin目录检查：

• 确认application/guifiles/Sample.fxml已存在
• 确认application/controllers/SampleController.class已生成
  之后重新运行项目即可。

内容的提问来源于stack exchange，提问作者Nathh.png