IntelliJ中JavaFX的FXML加载异常：控制器关联与启动矛盾

一、先搞对项目结构（核心） #

建议用资源和代码分离的标准结构，既能让程序正常加载FXML，又能让SceneBuilder找到控制器：

• Java控制器：src/main/java/view/ 底下（比如你的HelloController.java）
• FXML文件：src/main/resources/view/ 底下（和控制器对应同包路径的资源目录）

这种结构是Maven/Gradle的标准写法，不会出乱子。

二、改代码里的FXML加载路径 #

你现在代码里的路径写法有问题，导致两种场景都出问题：

1. 调整ViewHandler的加载代码 #

你现在重复创建了FXMLLoader，还写了两个不同的路径，直接改成这样：

package view;

import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.scene.image.Image;
import javafx.scene.paint.Color;
import javafx.stage.Stage;

import java.io.IOException;

public class ViewHandler extends Application {
    @Override
    public void start(Stage stage) throws IOException {
        try {
            // 用相对路径加载同包资源目录下的FXML
            Parent root = FXMLLoader.load(getClass().getResource("MainMenu.fxml"));
            Scene scene = new Scene(root, Color.BLACK);

            // 加载logo的时候用getResourceAsStream，避免路径问题
            Image icon = new Image(getClass().getResourceAsStream("/logo.png"));
            stage.getIcons().add(icon);

            stage.setTitle("Main Menu");
            stage.setScene(scene);
            stage.show();
        } catch(Exception e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        launch(args);
    }
}

2. 调整HelloController里的所有切换方法 #

把所有getClass().getResource("/XXX.fxml")改成getClass().getResource("XXX.fxml")，或者绝对路径"/view/XXX.fxml"，比如：

// 改成相对路径
root = FXMLLoader.load(getClass().getResource("MainMenu.fxml"));
// 或者绝对路径
root = FXMLLoader.load(getClass().getResource("/view/MainMenu.fxml"));

三、让SceneBuilder关联控制器 #

当FXML放在src/main/resources/view/时，打开SceneBuilder：

1. 打开你的FXML文件，找到右侧的"Controller"面板
2. 点"Browse"，找到src/main/java/view/下的HelloController.java
3. 确认控制器类名填view.HelloController（完整包名加类名）
   这样就能正常关联了。

四、为啥放同目录程序启动失败？ #

如果非要把FXML和Java放一起，得确保IDE把FXML文件也编译到输出目录（比如target/classes/view/），同时加载路径用相对路径。但这种写法不符合规范，后续维护容易出问题，不推荐。

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