JavaFX TreeView加载时出现镜像重复显示问题求助

问题根源 #

1. 非FX线程操作UI组件：你在后台线程直接修改TreeItem的子节点列表，JavaFX要求所有UI相关操作必须在FX应用线程中执行，跨线程修改会导致UI渲染混乱，出现节点重复显示的异常。
2. TreeCell复用未清理状态：CellFactory的updateItem方法中，当单元格为空（empty）或数据为null时，只清空了图形组件，但没有重置文本内容，导致单元格复用时残留旧文本，表现为底部的纯文本节点。

修复方案 #

1. 确保UI操作在FX线程执行

修改buildTree中的添加节点逻辑，用Platform.runLater()把更新操作提交到FX线程：

private Runnable buildTree() {
    return ()-> {
        for (int x = 0; x < 100; x++) {
            boolean checkBoxNode = x % 2 == 0;
            TreeItem<TreeNode> newNode = new TreeItem<>(new TreeNode(getName(), checkBoxNode));
            // 提交到FX线程执行UI更新
            Platform.runLater(() -> root.getChildren().add(newNode));
            sleep(500);
        }
    };
}

2. 完善TreeCell的状态清理

修改CellFactory的updateItem方法，在empty状态时同时清空文本和图形：

@Override
protected void updateItem(TreeNode treeNode, boolean empty) {
    super.updateItem(treeNode, empty);
    if (empty || treeNode == null) {
        setText(null); // 新增：清空文本
        setGraphic(null);
        checkBox.setVisible(false); // 额外处理：隐藏复选框避免复用干扰
    } else {
        checkBox.setSelected(treeNode.isSelected());
        checkBox.setVisible(treeNode.isCheckBoxNode());
        setText(treeNode.toString());
        setGraphic(checkBox);
    }
}

同时优化itemProperty的监听器，避免空指针：

itemProperty().addListener(((observable, oldValue, treeNode) -> {
    checkBox.setVisible(treeNode != null && treeNode.isCheckBoxNode());
}));

说明 #

• JavaFX的UI组件不是线程安全的，所有涉及UI状态修改的操作（包括TreeItem的子节点变更）都必须通过Platform.runLater()在FX线程执行。
• TreeCell采用复用机制，每次updateItem必须完全重置单元格的所有状态（文本、图形、组件可见性等），否则会出现旧数据残留的问题。

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