添加fx:id和onAction后JavaFX启动报错：Exception in Application start method

核心原因 #

这个异常的直接原因是：FXML文件未与对应的控制器类绑定，即便你在控制器里写了fx:id和事件方法，FXML加载时找不到关联的控制器，就会触发启动失败。

分步排查修复 #

1. 检查FXML根元素的controller属性 #

打开你的FXML文件，确认根容器（比如AnchorPane、BorderPane）必须带有fx:controller属性，值是控制器类的完整包名+类名。
示例：

<BorderPane xmlns="http://javafx.com/javafx/17" xmlns:fx="http://javafx.com/fxml/1" fx:controller="com.yourpackage.MainWindow">

用Scene Builder操作的话，直接在右侧「Controller」面板的「Controller Class」输入框里填完整类路径，别只写类名

2. 核对控制器类的规范 #

• 控制器里和FXML绑定的组件、事件方法必须加@FXML注解：

public class MainWindow {
    @FXML
    private TextField usernameField;
    @FXML
    private ComboBox<String> roleCombo;

    @FXML
    private void onLoginClick(ActionEvent event) {
        // 你的事件逻辑
    }
}

• 控制器不能是抽象类，必须有无参构造方法（没写的话Java会自动生成，但如果手动写了带参构造，一定要显式添加无参构造）

3. 检查FXML加载代码 #

在Main启动类的start方法里，确保FXML加载路径正确，示例：

@Override
public void start(Stage stage) throws IOException {
    FXMLLoader loader = new FXMLLoader(Main.class.getResource("/com/yourpackage/main-window.fxml"));
    Parent root = loader.load();
    stage.setScene(new Scene(root));
    stage.show();
}

注意：getResource的路径要和FXML实际位置匹配，Maven/Gradle项目里FXML要放在resources目录下

4. 项目编译与依赖检查 #

• 确认控制器类已编译成功，去target/classes目录下找对应的.class文件
• Maven/Gradle项目要确保javafx-fxml模块已正确引入，JavaFX版本和JDK版本兼容（比如JavaFX 17对应JDK 17及以上）

5. Scene Builder配置验证 #

• 打开Scene Builder，通过「File」→「Project Structure」确认JDK和JavaFX SDK路径正确
• 修改控制器绑定后，务必保存FXML，打开文本编辑器确认fx:controller属性确实被写入文件

模块化项目额外检查 #

如果是用module-info.java的模块化项目，必须在module-info里声明依赖并开放控制器所在包：

module com.yourpackage {
    requires javafx.controls;
    requires javafx.fxml;

    opens com.yourpackage to javafx.fxml;
}

内容的提问来源于stack exchange，提问作者Vitor Dos Santos