Intellij IDEA搭配Scene Builder运行JavaFX程序出现Location is Required错误求助

以下是针对你的问题给出的具体排查和修复方案：

1. 先搞定IDEA的资源配置（核心问题） #

"Location is required"本质是FXMLLoader找不到FXML文件，先确认IDEA是否将你的FXML文件识别为资源：

• 将FXML文件移至src/main/resources目录下；如果是普通Java项目，右键点击存放FXML的文件夹→选择Mark Directory as→Resources Root
• 编译项目后，前往out/production/classes目录查看，确认FXML文件已出现在对应路径中——如果没有，说明IDEA未将其打包进类路径，必须调整资源根配置。

2. 修正ClassLoader加载代码 #

如果你的FXML文件在sample包下，原加载代码的路径需要补全：

// 写法1：用ClassLoader，路径从资源根目录开始
Parent root = FXMLLoader.load(getClass().getClassLoader().getResource("sample/BlackJackMessage.fxml"));

// 写法2：不用ClassLoader，路径相对于当前类所在包（若当前类在sample包下）
Parent root = FXMLLoader.load(getClass().getResource("BlackJackMessage.fxml"));

3. 修复文件流加载的错误 #

你使用文件流的写法存在两处明显问题：

• loader.setController("BlackJackController")写法错误，必须传入Controller实例，比如loader.setController(new BlackJackController())；也可以直接在FXML文件顶部添加fx:controller="sample.BlackJackController"来指定控制器
• 加载顺序颠倒，需先设置控制器再执行加载操作：

File map = new File("C:/users/rbeto/internet_development/BlackJackV3/src/sample/BlackJackGame2.fxml");
InputStream fxmlStream = new FileInputStream(map);
FXMLLoader loader = new FXMLLoader();
loader.setController(new BlackJackController()); // 先设置控制器
Parent root = loader.load(fxmlStream); // 再执行加载

⚠️ 注意：绝对路径仅适用于本地调试，打包成jar包后会失效，推荐使用类路径加载方式。

4. 检查JavaFX运行配置 #

新版IDEA需手动配置JavaFX：

• 打开File→Project Structure→Libraries，添加JavaFX SDK的路径
• 打开Run→Edit Configurations，在VM Options中添加：

--module-path "你的JavaFX安装目录/lib" --add-modules javafx.controls,javafx.fxml

如果是Maven项目，直接在pom.xml中添加JavaFX依赖即可，无需手动配置VM参数。

5. 验证Scene Builder的文件路径 #

打开Scene Builder时，确认打开的是项目中实际的FXML文件，避免因保存路径错误导致文件位置不符。

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