Spring Boot注入Controller Bean时出现无源头ClassCastException如何解决

异常触发核心原因 #

• FXML路径配置错误：connectedConnectorsController 方法声明的返回类型为 ConnectedConnectorsController，但方法内调用loadController加载的FXML文件的fx:controller属性错误配置为ConnectorFittingResultController，或者直接写错了FXML文件路径，加载到了连接器适配结果页的FXML，导致返回的控制器类型和方法声明的返回类型不匹配。该类转换是Spring容器处理@Bean方法返回值时自动执行的，因此你不会在代码中看到显式的强制转换逻辑。
• FXMLLoader实例复用问题：如果自定义loadController方法中复用了同一个FXMLLoader实例，上一次加载ConnectorFittingResultController后没有清空控制器缓存，后续加载其他FXML时会直接返回之前缓存的控制器实例，导致类型错配。
• 泛型擦除导致的隐式转换问题：如果loadController是泛型方法（如public <T> T loadController(String fxmlPath)），泛型擦除后会自动做类型强转，当返回的实际类型和接收类型不匹配时就会抛出该异常，不会在代码中留下显式转换逻辑。
• Bean名称冲突：如果多个@Bean方法使用了相同的name属性，Spring容器会按注册顺序覆盖Bean，导致你声明的ConnectedConnectorsController类型的Bean实际被替换为ConnectorFittingResultController实例，注入时触发类型转换异常。

排查解决步骤 #

• 核对目标方法的配置：定位ControllerConfiguration类第156行的connectedConnectorsController方法，首先确认方法返回类型确实是ConnectedConnectorsController，再检查方法内传入loadController的FXML路径是否正确，打开对应FXML文件确认fx:controller属性的值为de.some.project.controller.connectedconnectors.ConnectedConnectorsController。
• 检查loadController实现：确认该方法每次调用都会新建独立的FXMLLoader实例，不会复用全局实例，参考正确实现如下：

private <T> T loadController(String fxmlPath) throws IOException {
    // 每次加载都新建独立的FXMLLoader，避免缓存污染
    FXMLLoader loader = new FXMLLoader(getClass().getResource(fxmlPath));
    loader.load();
    return loader.getController();
}

• 排查Bean名称冲突：检查所有@Bean方法的name属性，确认没有重名的情况，也可以给connectedConnectorsController的@Bean注解显式指定name，避免默认名称冲突。
• 验证作用域配置：确认connectedConnectorsController方法的@Scope注解确实配置为SCOPE_PROTOTYPE，没有被上层单例Bean提前注入导致类型绑定错误。

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