JavaFX可执行Jar无法打开新场景问题求助

我之前碰到过好几个类似的场景——在IDE里运行一切正常，打包成Jar后就出现窗口不显示的情况，结合你给出的代码片段，大概率是这几个原因导致的，你可以逐一排查：

1. 资源路径加载错误（最常见） #

在Eclipse中运行时，资源文件（比如FXML、图片）是直接从本地文件系统读取的，但打包成Jar后，这些资源是嵌入在Jar包内部的，必须通过类路径来加载，而不是本地文件路径。

比如你之前如果是这样加载FXML的：

FXMLLoader loader = new FXMLLoader(new File("fxml/ThirdWindow.fxml").toURI().toURL());

改成类路径加载的方式，注意路径开头的斜杠代表类路径的根目录：

FXMLLoader loader = new FXMLLoader(getClass().getResource("/fxml/ThirdWindow.fxml"));

如果还是找不到，试试用上下文类加载器：

ClassLoader classLoader = Thread.currentThread().getContextClassLoader();
FXMLLoader loader = new FXMLLoader(classLoader.getResource("/fxml/ThirdWindow.fxml"));

2. 异常被静默吞掉，看不到报错 #

Jar包运行时如果没有打开控制台，你根本不知道哪里出了问题。给Start按钮的事件处理加上完整的异常捕获，要么打印到控制台，要么用弹窗显示错误信息：

Start.setOnAction(e -> {
    try {
        // 先关闭当前窗口
        ((Stage) Start.getScene().getWindow()).close();
        
        // 初始化第三个窗口
        Stage thirdStage = new Stage();
        FXMLLoader loader = new FXMLLoader(getClass().getResource("/fxml/ThirdWindow.fxml"));
        Parent root = loader.load();
        thirdStage.setScene(new Scene(root));
        thirdStage.setTitle("Third Window");
        thirdStage.show();
    } catch (Exception ex) {
        // 打印异常到控制台（如果能看到的话）
        ex.printStackTrace();
        
        // 或者用弹窗展示错误，方便排查
        Alert errorAlert = new Alert(Alert.AlertType.ERROR);
        errorAlert.setTitle("窗口加载失败");
        errorAlert.setHeaderText("无法打开第三个窗口");
        errorAlert.setContentText("错误信息：" + ex.getMessage() + "\n\n详细栈追踪：" + Arrays.toString(ex.getStackTrace()));
        errorAlert.showAndWait();
    }
});

3. 窗口关闭与新建的顺序问题 #

JavaFX默认会在最后一个Stage关闭时终止Application。如果你先关闭第二个窗口，再新建第三个窗口，可能会触发Application的退出逻辑，导致新窗口还没显示就被终止了。

试试调换顺序：先新建并显示第三个窗口，再关闭第二个窗口：

Start.setOnAction(e -> {
    try {
        // 先创建并显示第三个窗口
        Stage thirdStage = new Stage();
        FXMLLoader loader = new FXMLLoader(getClass().getResource("/fxml/ThirdWindow.fxml"));
        Parent root = loader.load();
        thirdStage.setScene(new Scene(root));
        thirdStage.setTitle("Third Window");
        thirdStage.show();
        
        // 再关闭当前窗口
        ((Stage) Start.getScene().getWindow()).close();
    } catch (Exception ex) {
        // 异常处理
    }
});

4. 打包时资源文件未被包含 #

检查你打包Jar的过程：

• 如果用Eclipse导出Jar，要确保在导出向导中勾选了所有资源文件（比如FXML、配置文件等），不要只选Java类。
• 如果用Maven/Gradle打包，确认构建脚本中配置了资源目录的打包规则，比如Maven的pom.xml里要确保src/main/resources目录被正确打包。

按照上面的步骤排查，基本就能解决问题了。

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