JavaFX代码创建ListCtrl时@FXML注解成员注入失败问题

直接通过new ListCtrl()实例化控制器时，JavaFX的@FXML注解字段不会自动注入——因为FXML的依赖注入是由FXMLLoader加载FXML文件的过程中完成的，手动创建的控制器对象不会触发这个注入流程。

1. 绑定FXML与控制器 #

在List.fxml的根节点中，通过fx:controller属性指定控制器类，示例：

<AnchorPane fx:controller="com.yourpackage.ListCtrl" xmlns:fx="http://javafx.com/fxml">
    <!-- 你的按钮、标题、VBox等节点定义 -->
</AnchorPane>

2. 用FXMLLoader加载并获取控制器 #

不要手动new控制器，通过FXMLLoader加载FXML，自动完成控制器实例化和字段注入：

public void refresh() {
    try {
        FXMLLoader loader = new FXMLLoader(getClass().getResource("List.fxml"));
        Parent listRoot = loader.load();
        
        // 获取已完成注入的控制器实例
        ListCtrl listCtrl = loader.getController();
        
        // 将加载好的列表节点添加到看板容器
        yourKanbanContainer.getChildren().add(listRoot);
        // 此时可正常调用控制器的方法或操作@FXML字段
    } catch (IOException e) {
        e.printStackTrace();
    }
}

3. 避开手动实例化的误区 #

之前手动new控制器的写法（如下）会导致@FXML字段为null，必须彻底放弃：

// 错误写法，无注入效果
ListCtrl listCtrl = new ListCtrl();

4. 控制器内的初始化逻辑 #

不要在控制器的无参构造方法中操作@FXML字段（构造方法执行时注入还未完成），改用initialize()方法：

public class ListCtrl {
    @FXML
    private Button listBtn;
    @FXML
    private VBox contentBox;

    // FXMLLoader加载完成后自动调用
    @FXML
    private void initialize() {
        listBtn.setOnAction(e -> { /* 按钮点击逻辑 */ });
    }

    // 自定义方法，用于外部传递数据
    public void setListData(Object data) {
        // 处理传入的数据
    }
}

如果需要给控制器传数据，在获取控制器实例后调用自定义方法即可：

ListCtrl listCtrl = loader.getController();
listCtrl.setListData(yourData);

如果修改后出现listObject为null，大概率是FXML文件路径错误导致加载失败，检查两点：

• 确认FXML路径正确：和控制器同包用getClass().getResource("List.fxml")，如果在resources目录下，路径要写成"/com/yourpackage/List.fxml"（开头加斜杠）。
• 查看IOException的堆栈信息，定位具体错误（比如文件找不到、FXML语法错误）。

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