Eclipse运行main.java后JavaFX应用窗口未显示问题

这类无报错但窗口不显示的问题，基本都是资源加载静默失败、运行配置缺失导致异常被吞，没有触发明显崩溃提示，按以下顺序排查即可： #

1. 先解决异常被吞的问题 #

你当前代码把所有异常捕获后仅打印栈轨迹，Eclipse经常会出现控制台未切换到当前运行实例、漏打日志的情况，导致看不到实际报错。先修改catch块，强制显式提示错误：

catch(Exception e) {
    e.printStackTrace();
    // 强制弹出错误提示，避免漏看控制台日志
    javafx.scene.control.Alert alert = new javafx.scene.control.Alert(javafx.scene.control.Alert.AlertType.ERROR);
    alert.setContentText("加载失败：" + e.getMessage());
    alert.showAndWait();
}

修改后再运行，如果弹出错误提示，直接根据提示内容定位问题即可。 #

2. 检查资源文件路径 #

你代码里用的是相对类路径加载资源：

• FXMLLoader.load(getClass().getResource("Sample.fxml"))
• getClass().getResource("application.css")
  这两个写法要求Sample.fxml和application.css必须和Main.class位于同一个编译输出目录，也就是源码中直接放在application包下，和Main.java同层级。
  可以在加载资源前加两行打印验证路径是否正确：

System.out.println("FXML文件路径：" + getClass().getResource("Sample.fxml"));
System.out.println("CSS文件路径：" + getClass().getResource("application.css"));

如果打印结果为null，说明文件放错位置，挪到application包下即可。如果确认文件位置正确还是null，右键项目 -> Build Path -> Configure Build Path，检查是否把fxml、css后缀的文件排除在编译输出之外，确保这类资源文件会被拷贝到class输出目录。 #

3. 检查JavaFX运行配置 #

如果你用的是JDK11及以上版本，JavaFX已经从JDK中独立出来，需要手动配置运行参数：

• 先确认已经把JavaFX SDK的所有jar包加入项目构建路径
• 右键项目 -> Run As -> Run Configurations，找到对应的Java Application运行配置，在VM arguments栏填入以下参数（替换成你本地JavaFX SDK的lib目录绝对路径）：

--module-path "本地JavaFX SDK的lib目录路径" --add-modules javafx.controls,javafx.fxml

• 确认运行配置里的Main class填写的是application.Main，不要选IDE自动生成的其他主类。

4. 检查FXML文件本身合法性 #

• 确认Sample.fxml的根节点是BorderPane，否则你代码里强转BorderPane会抛出类型转换异常
• 确认fxml中fx:controller配置的控制器类全路径正确，控制器类存在、没有编译错误，控制器的initialize方法没有抛出未捕获的运行时异常

排查完以上几点基本就能解决问题，极少数情况是窗口初始坐标被设置到了屏幕可视区域外，可以在primaryStage.show()前加一行primaryStage.centerOnScreen()强制窗口居中排除这个可能。

内容的提问来源于stack exchange，提问作者Hammam Abo Jamous