JavaFX多FXML场景切换失败求助：存在空指针异常问题

嘿，我看你在JavaFX场景切换时碰到了NullPointerException的坑，这问题我之前也踩过！咱们先搞清楚为啥会出这个错，再一步步给你改好代码。

问题根源 #

你在Main类里用@FXML注解了Button button，但**Main并不是FXML文件对应的控制器类**！@FXML注解只能在FXML文件指定的控制器类中生效，所以这个button变量根本没被初始化，调用button.setOnMouseClicked的时候自然就抛出空指针异常了。

正确的实现方案 #

咱们把UI交互逻辑放到对应的控制器类里，Main只负责启动应用和初始化第一个场景就好。下面是具体的修改步骤和代码示例：

1. 给第一个场景的FXML配置控制器 #

假设你的第一个FXML是SceneOneController.fxml（对应服务器连接场景），我们创建专门的控制器SceneOneController来处理按钮点击事件：

import javafx.fxml.FXML;
import javafx.fxml.FXMLLoader;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.stage.Stage;
import java.io.IOException;

public class SceneOneController {
    // 这个fx:id要和FXML文件里的按钮id完全对应
    @FXML
    private Button switchToGameButton;

    // 初始化方法，可选，用来设置控件初始状态
    @FXML
    public void initialize() {
        // 比如可以在这里给按钮加提示文本
        switchToGameButton.setTooltip(new Tooltip("点击进入游戏"));
    }

    // 按钮点击事件处理方法，要和FXML里的onAction绑定
    @FXML
    private void handleSwitchToGame() {
        try {
            // 获取当前按钮所在的窗口（Stage）
            Stage currentStage = (Stage) switchToGameButton.getScene().getWindow();

            // 加载游戏场景的FXML文件
            FXMLLoader loader = new FXMLLoader(getClass().getResource("MainController.fxml"));
            Parent gameRoot = loader.load();

            // 如果需要传递服务器连接信息（比如host和port），可以这样获取游戏控制器并传值
            Controller2 gameController = loader.getController();
            gameController.setServerInfo("localhost", 2123); // 这里可以换成你从登录场景获取的真实值

            // 切换到新场景
            Scene gameScene = new Scene(gameRoot, 700, 700);
            currentStage.setScene(gameScene);
            currentStage.setTitle("游戏场景");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

2. 修改Main类，只负责初始化主窗口 #

把Main类里的控件操作全部删掉，只保留启动第一个场景的逻辑：

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

public class Main extends Application {
    @Override
    public void start(Stage primaryStage) throws Exception {
        // 加载服务器连接场景的FXML
        FXMLLoader loader = new FXMLLoader(getClass().getResource("SceneOneController.fxml"));
        Parent root = loader.load();

        primaryStage.setTitle("服务器连接场景");
        primaryStage.setScene(new Scene(root, 700, 700));
        primaryStage.getIcons().add(new Image("/sample/R_enormousRing.png"));
        primaryStage.show();
    }

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

3. 配置FXML文件的控制器和事件绑定 #

在你的SceneOneController.fxml里，要指定控制器类，并且把按钮的onAction绑定到刚才写的handleSwitchToGame方法：

<?xml version="1.0" encoding="UTF-8"?>
<?import javafx.scene.control.Button?>
<?import javafx.scene.layout.VBox?>
<?import javafx.scene.control.Tooltip?>

<VBox alignment="CENTER" spacing="20" xmlns:fx="http://javafx.com/fxml" 
      fx:controller="sample.SceneOneController"> <!-- 这里指定控制器类的全路径 -->
    <Button fx:id="switchToGameButton" text="连接服务器并进入游戏">
        <tooltip>
            <Tooltip text="点击后将连接到指定服务器并进入游戏场景"/>
        </tooltip>
        <onAction>#handleSwitchToGame</onAction> <!-- 绑定点击事件方法 -->
    </Button>
    <!-- 这里可以添加你的服务器连接输入框等控件 -->
</VBox>

4. 完善游戏场景的控制器（Controller2） #

如果需要接收服务器信息，可以给Controller2加对应的方法：

import javafx.fxml.FXML;

public class Controller2 {
    // 可以添加游戏场景的控件注解
    // @FXML private SomeGameControl gameControl;

    // 接收服务器信息的方法
    public void setServerInfo(String hostName, int portNumber) {
        // 这里可以用接收到的信息初始化游戏的服务器连接
        System.out.println("连接到服务器: " + hostName + ":" + portNumber);
        // 比如初始化游戏客户端逻辑
    }

    @FXML
    public void initialize() {
        // 游戏场景的初始化逻辑
    }
}

额外提示 #

• 所有FXML文件要确保放在项目的资源目录下，或者和对应的控制器类同包，这样getClass().getResource()才能正确加载。
• 如果需要打开新窗口而不是切换当前窗口，可以创建新的Stage对象，调用stage.show()即可，不用修改原窗口的场景。

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