JavaFX通过fx:include引入独立FXML触发NullPointerException的原因排查

该异常完全来自JavaFX FXML加载机制和当前代码写法的不匹配，完整逻辑链路如下：

• JavaFX 的 FXML 控制器生成规则为：每一个被FXMLLoader独立加载的FXML文件，只要在根节点声明了fx:controller属性，就会创建一个该控制器类的全新独立实例。不同文件加载生成的控制器对象完全隔离，不会跨文件共享同一个实例。
• 你当前代码的实际运行流程：
  1. 加载主界面main.fxml时，会生成第一个MainController实例，系统自动将main.fxml内fx:id="label"的Label节点注入到该实例的label字段，此时这个实例的字段引用完全正常。
  2. 主FXML中的fx:include标签触发button.fxml加载时，因为button.fxml的根节点同样声明了fx:controller="org.example.MainController"，系统会创建第二个完全独立的MainController实例。这个实例的字段注入范围仅覆盖button.fxml文件内部定义的组件，由于button.fxml中根本不存在fx:id为label的节点，这个新实例的label字段从初始化开始就始终是null。
• FXML中的事件绑定和所在文件的控制器实例一一对应：button.fxml里按钮的onAction="#changeLabel"配置，绑定的是加载该文件时生成的第二个MainController实例的changeLabel()方法，和主界面加载生成的、持有正常Label引用的第一个MainController实例没有任何关联。
• 点击按钮触发事件时，实际执行的是第二个实例的changeLabel()方法，方法内执行label.setText("Changed")操作时，因为对应的label字段是未注入的null值，直接抛出NullPointerException。

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