JavaFX Stage始终显示空白场景问题求助

我来帮你解决这个头疼的空白场景问题！结合你用的IntelliJ IDEA社区版、Java JDK 9.0.1、Scene Builder 9.0.1，还有你的代码，我整理了几个最可能的原因和实操解决方案：

1. 先查FXML文件的路径是否正确 #

你的Main类在view包下，用getClass().getResource("sample.fxml")加载FXML，这意味着sample.fxml必须和编译后的Main.class在同一个目录里：

• 如果是普通Java项目：把sample.fxml直接放在src/view目录下，和Main.java同层级
• 如果是Maven/Gradle项目：FXML文件得放在src/main/resources/view目录，这样编译后会自动复制到classes/view，和Main.class对齐

你可以加一行代码验证资源是否能找到，避免暗坑：

URL fxmlUrl = getClass().getResource("sample.fxml");
System.out.println(fxmlUrl); // 要是输出null，百分百是路径错了！
Parent root = FXMLLoader.load(fxmlUrl);

2. Java 9模块系统是重灾区！（必看） #

Java 9开始搞模块系统了，如果你的项目是模块化的（有module-info.java），必须配置对JavaFX的依赖和权限，不然FXML根本找不到控制器：
创建或者修改module-info.java，加上这些内容：

module 你的项目模块名 {
    requires javafx.controls;
    requires javafx.fxml;
    
    // 必须开放view包给FXML用，不然它没法实例化控制器
    opens view to javafx.fxml;
}

很多Java 9+的空白场景问题都是栽在这个配置上，别漏了！

3. 给FXML的按钮加个明确的布局约束 #

你的FXML里的Button没指定GridPane的行列，虽然默认会放在(0,0)，但有时候可能因为布局逻辑问题显示不出来，加个约束更稳妥：

<GridPane alignment="center" hgap="10" vgap="10" xmlns:fx="http://javafx.com/fxml/1" xmlns="http://javafx.com/javafx/9.0.1" fx:controller="view.Controller">
  <children>
    <Button mnemonicParsing="false" text="Button" GridPane.rowIndex="0" GridPane.columnIndex="0"/>
  </children>
</GridPane>

4. 检查IntelliJ的项目配置 #

• 确保IntelliJ正确识别了JavaFX库：去File > Project Structure > Libraries里，把JavaFX对应Java9版本的lib目录加进去
• 如果是模块化项目，在运行配置里，检查VM options有没有配置错误，模块路径是否正确

5. 抓出隐藏的加载异常 #

有时候加载失败但没抛明显错误，你可以在start方法里加个异常捕获，看看到底哪里出问题：

@Override
public void start(Stage primaryStage) {
    try {
        Parent root = FXMLLoader.load(getClass().getResource("sample.fxml"));
        primaryStage.setTitle("Hello World");
        primaryStage.setScene(new Scene(root, 600, 400));
        primaryStage.show();
    } catch (Exception e) {
        e.printStackTrace(); // 把错误信息打出来，一目了然
    }
}

先从路径和模块配置这两个最常见的坑查起，应该很快就能解决空白场景的问题啦！

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