Spring整合JavaFX加载FXML时Bean找不到异常求助

核心问题分析 #

触发javafx.fxml.LoadException的根源是Spring容器无法识别documents.controller.MainWindowController为托管Bean，常见诱因包括：Controller未添加Spring组件注解、组件扫描范围未覆盖Controller所在包、FXML加载逻辑未结合Spring容器、FXML中Controller类路径声明错误。

针对性解决方案 #

1. 给Controller添加Spring组件注解 #

确保MainWindowController类上标注@Component（或@Controller，@Component更通用），让Spring能扫描到它：

package documents.controller;

import org.springframework.stereotype.Component;
import javafx.fxml.FXML;

@Component
public class MainWindowController {
    // 你的Controller业务代码
}

2. 确认Spring组件扫描范围 #

如果启动类所在包与documents.controller不在同一层级，需在启动类的@SpringBootApplication注解中手动指定扫描路径：

@SpringBootApplication(scanBasePackages = {"documents.controller", "你的其他业务包路径"})
public class DocCreatorApplication extends Application {
    // 启动逻辑代码
}

3. 用Spring容器加载FXML #

不要使用JavaFX原生的FXMLLoader.load()方法，而是让Spring负责Controller的实例化。在启动类的start方法中配置FXMLLoader的控制器工厂：

@Override
public void start(Stage primaryStage) throws Exception {
    AnnotationConfigApplicationContext springContext = new AnnotationConfigApplicationContext(DocCreatorApplication.class);
    
    FXMLLoader fxmlLoader = new FXMLLoader(getClass().getResource("/mainWindow.fxml"));
    fxmlLoader.setControllerFactory(springContext::getBean); // 委托Spring创建Controller实例
    
    Parent root = fxmlLoader.load();
    primaryStage.setScene(new Scene(root));
    primaryStage.show();
}

4. 校验FXML中的Controller声明 #

确保FXML根节点的fx:controller属性值为Controller的完整全类名，与实际代码包路径一致：

<?xml version="1.0" encoding="UTF-8"?>
<?import javafx.scene.layout.BorderPane?>
<BorderPane xmlns:fx="http://javafx.com/fxml" fx:controller="documents.controller.MainWindowController">
    <!-- FXML布局内容 -->
</BorderPane>

快速排查验证 #

• 在启动类中添加代码，打印Spring容器中的所有Bean名称，确认MainWindowController是否被扫描到：

for (String beanName : springContext.getBeanDefinitionNames()) {
    System.out.println(beanName);
}

• 检查pom.xml中Spring Boot与JavaFX的依赖版本兼容性，建议使用Spring Boot 3.x搭配JavaFX 17及以上版本。

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