在 JavaFX 中，通过 FXMLLoader 加载 FXML 时若手动创建 Controller 实例，会导致该实例与实际渲染的 UI 控制器不一致，从而造成 stage 字段为 null；正确做法是通过 setController() 显式绑定控制器，确保事件处理逻辑作用于真实运行的控制器实例。
在 javafx 中，通过 fxmlloader 加载 fxml 时若手动创建 controller 实例，会导致该实例与实际渲染的 ui 控制器不一致，从而造成 stage 字段为 null；正确做法是通过 `setcontroller()` 显式绑定控制器，确保事件处理逻辑作用于真实运行的控制器实例。
在你的代码中，问题根源在于：你创建了一个 SignInUIController 实例并调用 setStage()，但这个实例并未被 FXMLLoader 使用。FXMLLoader 默认会通过反射自动实例化控制器（即调用无参构造函数），因此最终显示界面所绑定的其实是另一个、未初始化 stage 的控制器对象——这就导致 cancel() 方法中 this.stage 始终为 null。
✅ 正确做法是：让 FXMLLoader 使用你已配置好的控制器实例，而非让它自行创建新的实例。只需在加载前调用 fxmlLoader.setController()：
Stage signIn = new Stage();
FXMLLoader fxmlLoader = new FXMLLoader(HelloApplication.class.getResource("SignInUI.fxml"));
SignInUIController signInUIController = new SignInUIController();
signInUIController.setStage(signIn); // 先设置 stage
fxmlLoader.setController(signInUIController); // ✅ 关键：显式指定控制器
try {
Scene sceneSignIn = new Scene(fxmlLoader.load());
signIn.setTitle("Sign In");
signIn.setScene(sceneSignIn);
signIn.getIcons().add(new Image("calculator.jpg"));
signIn.show();
} catch (IOException e) {
e.printStackTrace();
}
同时，保持 SignInUIController 中的字段和方法简洁安全：
public class SignInUIController {
private Stage stage;
public void setStage(Stage stage) {
this.stage = stage;
}
@FXML
private void cancel() {
if (stage != null && stage.isShowing()) {
stage.close();
}
}
}
⚠️ 注意事项：
- ❌ 不要再在 FXML 文件中声明
fx:controller="..."，否则会与setController()冲突（FXMLLoader 将忽略你传入的 controller）； - ✅ 若需保留 FXML 中的
fx:controller，则应改用setControllerFactory()配合依赖注入容器（如 Spring），但对简单场景过度复杂； - ? 可通过在
initialize()方法中打印this.toString()验证控制器是否唯一且复用成功； - ?️ 在调用
stage.close()前建议判空并检查isShowing()，避免运行时异常。
总结：JavaFX 的控制器生命周期由 FXMLLoader 管理，“谁创建，谁负责”——你手动 new 出来的 controller 必须通过 setController() 主动交由 loader 使用，才能保证事件回调与业务状态的一致性。这是跨控制器通信（如传递 Stage、主窗口引用等）的基础前提。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
