当在 FXML 中声明 fx:controller 后，必须通过 FXMLLoader.getController() 获取由 FXMLLoader 自动实例化的控制器对象；若手动 new 创建控制器，其 @FXML 字段（如 wall）将始终为 null，导致 NullPointerException。
当在 fxml 中声明 `fx:controller` 后，必须通过 `fxmlloader.getcontroller()` 获取由 fxmlloader 自动实例化的控制器对象；若手动 `new` 创建控制器，其 `@fxml` 字段（如 `wall`）将始终为 `null`，导致 `nullpointerexception`。
你遇到的错误 Cannot invoke "javafx.scene.shape.Rectangle.setX(double)" because "this.wall" is null 并非 Scene Builder 配置遗漏，而是典型的 FXML 控制器生命周期误用问题。
核心原因在于：你在 LabyrinthName.submit() 方法中手动创建了 LabyrinthCreate 实例：
LabyrinthCreate create = new LabyrinthCreate(); // ❌ 错误：手动 new，无 FXML 注入 // ... create.createLab(window);
而 LabyrinthCreate 类中声明了 @FXML private Rectangle wall;，但该字段仅在 FXMLLoader 加载对应 FXML 时，由 JavaFX 反射机制自动注入——前提是使用的是 FXMLLoader 创建的“受管控制器”（managed controller）。手动 new 的实例完全游离于 FXML 生命周期之外，所有 @FXML 字段保持默认值 null。
✅ 正确做法是：让 FXMLLoader 负责创建控制器，并在 load() 后立即获取它：
// 在 LabyrinthName.java 的 submit() 方法中修改如下：
@FXML
public void submit(ActionEvent event) throws Exception {
Name = nametext.getText();
Surname = surnametext.getText();
Model.getInstance().createUser(Name, Surname);
// ✅ 正确：由 FXMLLoader 实例化控制器，并注入 wall 等字段
FXMLLoader loader = new FXMLLoader(getClass().getResource("/com/maze/FXML/Scene3.fxml"));
Parent root = loader.load();
// ✅ 关键：获取 FXMLLoader 创建的、已注入字段的控制器实例
LabyrinthCreate controller = loader.getController();
controller.createLab((Stage) submitbutton.getScene().getWindow());
Stage window = (Stage) submitbutton.getScene().getWindow();
window.setScene(new Scene(root, 1000, 900));
window.setResizable(false);
}
同时，请确保 Scene3.fxml 的根元素正确声明了控制器类：
<!-- Scene3.fxml --> <vbox ... fx:controller="com.maze.ViewModels.LabyrinthCreate"><children><rectangle fx:id="wall" ...></rectangle></children></vbox>
⚠️ 注意事项：
-
fx:id="wall"必须与@FXML private Rectangle wall;的字段名严格一致（大小写敏感）； -
Scene3.fxml文件路径/com/maze/FXML/Scene3.fxml必须存在于 classpath 中，且资源可访问； -
LabyrinthCreate类不能有带参构造函数（或需配合自定义setControllerFactory），否则默认反射实例化可能失败； - 不要在控制器类中覆盖
initialize()方法逻辑前调用@FXML字段——它们仅在loader.load()完成后才被注入。
? 进阶建议：若需在控制器间传递数据（如用户信息），推荐通过 FXMLLoader.setController() 显式设置，或利用单例模型（如你的 Model.getInstance()）解耦，避免强依赖控制器实例传递。
遵循以上规范，wall 将被正确注入，wall.setX(100) 等操作即可安全执行。FXML 的本质是声明式 UI 与控制器的绑定契约，尊重其加载流程，是 JavaFX 开发的基石。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
