Spring JavaFX切换登录到Admin场景时Location未设置异常求助

错误根源分析 #

IllegalStateException: Location is not set 通常由以下两个核心原因导致：

1. FXML路径错误：未正确指向resources目录下的FXML文件，或使用了错误的相对路径
2. Spring与JavaFX控制器冲突：直接使用FXMLLoader.load()时，默认加载逻辑会尝试实例化控制器，与Spring容器管理的控制器实例冲突；同时FXML文件中手动指定fx:controller也会引发加载冲突

方案一：用FXWeaver整合Spring与JavaFX（推荐） #

1. 添加FXWeaver依赖 #

Maven项目在pom.xml中加入：

<dependency>
    <groupId>net.rgielen</groupId>
    <artifactId>javafx-weaver-spring-boot-starter</artifactId>
    <version>1.3.0</version> <!-- 使用最新稳定版 -->
</dependency>

2. 修正Spring启动类 #

让启动类继承Application，通过FXWeaver初始化Spring容器与JavaFX视图：

@SpringBootApplication
public class AppApplication extends Application {
    private ConfigurableApplicationContext context;
    private FxWeaver fxWeaver;

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

    @Override
    public void init() throws Exception {
        context = SpringApplication.run(AppApplication.class);
        fxWeaver = context.getBean(FxWeaver.class);
    }

    @Override
    public void start(Stage primaryStage) throws Exception {
        // 初始加载登录视图
        Parent root = fxWeaver.loadView(LoginController.class);
        primaryStage.setScene(new Scene(root));
        primaryStage.show();
    }

    @Override
    public void stop() throws Exception {
        context.close();
    }
}

3. 调整控制器与FXML配置 #

• 给LoginController和AdminController添加@Component注解，让Spring管理实例：

  @Component
  public class LoginController implements Initializable {
      // 控制器逻辑...
  }
  

• 删除FXML文件中的fx:controller属性，避免与Spring容器的控制器实例冲突

4. 重构ViewUtils的场景切换方法 #

通过FXWeaver加载Spring管理的视图：

@Component
public class ViewUtils {
    private final FxWeaver fxWeaver;

    // 构造注入FXWeaver
    public ViewUtils(FxWeaver fxWeaver) {
        this.fxWeaver = fxWeaver;
    }

    public void changeScene(Stage stage, Class<? extends Initializable> controllerClass) {
        Parent root = fxWeaver.loadView(controllerClass);
        Scene scene = new Scene(root);
        stage.setScene(scene);
        stage.show();
    }
}

5. 修正LoginController的登录逻辑 #

注入ViewUtils，验证通过后切换场景：

@Component
public class LoginController implements Initializable {
    @FXML
    private TextField usernameField;
    @FXML
    private PasswordField passwordField;
    @FXML
    private Button loginBtn;

    private final ViewUtils viewUtils;
    private final UserService userService; // 你的用户验证服务

    // 构造注入依赖
    public LoginController(ViewUtils viewUtils, UserService userService) {
        this.viewUtils = viewUtils;
        this.userService = userService;
    }

    @Override
    public void initialize(URL url, ResourceBundle resourceBundle) {
        loginBtn.setOnAction(this::userLogin);
    }

    private void userLogin(ActionEvent event) {
        String username = usernameField.getText();
        String password = passwordField.getText();

        if (userService.validateCredentials(username, password)) {
            Stage stage = (Stage) ((Node) event.getSource()).getScene().getWindow();
            viewUtils.changeScene(stage, AdminController.class);
        } else {
            Alert alert = new Alert(Alert.AlertType.ERROR);
            alert.setTitle("登录失败");
            alert.setContentText("用户名或密码错误");
            alert.showAndWait();
        }
    }
}

方案二：手动整合Spring与FXMLLoader（无需FXWeaver） #

如果不想使用FXWeaver，可手动从Spring容器获取控制器并绑定到FXMLLoader：

@Component
public class ViewUtils {
    private final ApplicationContext context;

    public ViewUtils(ApplicationContext context) {
        this.context = context;
    }

    public void changeScene(Stage stage, String fxmlPath, Class<?> controllerClass) {
        try {
            FXMLLoader loader = new FXMLLoader(getClass().getResource(fxmlPath));
            // 从Spring容器获取控制器实例
            loader.setController(context.getBean(controllerClass));
            Parent root = loader.load();
            Scene scene = new Scene(root);
            stage.setScene(scene);
            stage.show();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

调用示例：

// 假设admin-view.fxml放在resources/fxml目录下
viewUtils.changeScene(stage, "/fxml/admin-view.fxml", AdminController.class);

同样需要删除FXML中的fx:controller属性，并给控制器添加@Component注解。

关键注意事项 #

• FXML文件必须放在src/main/resources目录下，路径使用绝对路径（以/开头）
• 所有JavaFX控制器必须由Spring管理，避免手动实例化
• 禁止同时在FXML中指定fx:controller和通过Spring注入控制器，否则会引发实例冲突

内容的提问来源于stack exchange，提问作者Mădălina Oprea