JavaFX中FilteredList返回重复结果问题求助

你遇到的重复显示问题和FilteredList无关——从你打印的日志能看到过滤结果是正确的，问题出在自定义ListCell的实现上。ListView的Cell采用复用机制，每次调用updateItem()时，你没有正确清理旧的UI组件，导致新组件叠加在旧组件上，看起来像是重复条目。

原代码的核心问题 #

• 当empty || item == null时，仅设置了setText(null)，但未清空graphic，旧的HBox组件会残留Cell中；
• 每次有有效item时都重新创建Label、HBox、VBox，未复用组件，Cell被复用时新旧组件叠加显示。

修复后的ListCell代码 #

playList.setCellFactory(param -> new ListCell<Song>() {
    // 将UI组件声明为Cell成员变量，仅初始化一次
    private final Label numberLabel = new Label();
    private final Label titleLabel = new Label();
    private final Label artistLabel = new Label();
    private final Label durationLabel = new Label();
    private final VBox vbox = new VBox(titleLabel, artistLabel);
    private final HBox hbox = new HBox(numberLabel, vbox, durationLabel);

    {
        // 初始化布局样式，仅执行一次
        vbox.setMinWidth(275);
        numberLabel.setMinWidth(36);
        HBox.setMargin(durationLabel, new Insets(7, 5, 5, 5));
        HBox.setMargin(numberLabel, new Insets(7, 0, 5, 5));
    }

    @Override
    protected void updateItem(Song item, boolean empty) {
        super.updateItem(item, empty);

        if (empty || item == null) {
            setText(null);
            setGraphic(null); // 关键：清空graphic，避免旧组件残留
        } else {
            // 仅更新组件内容，不重新创建组件
            numberLabel.setText(String.valueOf(item.getsongNumber()));
            titleLabel.setText(item.getTitle());
            artistLabel.setText(item.getArtist());
            durationLabel.setText(item.getDuration());
            setGraphic(hbox);
        }
    }
});
playList.setItems(songs);

优化FilteredList的使用（可选，更高效） #

原代码每次过滤都新建FilteredList并调用refresh()，属于冗余操作。可以提前创建FilteredList绑定原列表，仅更新过滤条件即可：

// 初始化时创建一次FilteredList
private final FilteredList<Song> filteredList = new FilteredList<>(songs);

// 初始化阶段就将FilteredList设为ListView的数据源
playList.setItems(filteredList);

// 简化过滤方法
private void filterSongs(String keyword) {
    String lowerKeyword = keyword.toLowerCase();
    filteredList.setPredicate(song -> 
        song.getTitle().toLowerCase().contains(lowerKeyword) ||
        song.getArtist().toLowerCase().contains(lowerKeyword)
    );
    // 无需调用setItems和refresh，FilteredList会自动通知ListView更新
}

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