带复选框的可筛选RecyclerView搜索时选中项异常问题

嘿，我来帮你搞定这个RecyclerView搜索时只有第一项被选中的bug～ 先给你分析下问题根源，再一步步给你解决方案：

问题根源 #

你现在的选中状态大概率是和**列表位置(position)**绑定的（比如用Set<Integer>存选中的位置），但搜索后列表会重新筛选排序，原来的位置对应的已经不是之前选中的店铺了；再加上RecyclerView的ViewHolder复用机制，就会出现选中状态“串位”，只显示第一项被选中的情况。

核心解决思路：把选中状态和店铺数据本身绑定，而不是和列表位置绑定。

具体解决方案 #

方案1：给FShop实体类加选中状态字段（推荐，最简单） #

如果允许修改FShop的代码，直接给它加一个isSelected布尔属性，用来记录当前店铺是否被选中：

public class FShop {
    // 你的原有字段，比如id、店铺名等
    private String shopId;
    private String shopName;
    
    // 新增选中状态字段
    private boolean isSelected;

    // 生成getter和setter
    public boolean isSelected() {
        return isSelected;
    }

    public void setSelected(boolean selected) {
        isSelected = selected;
    }
}

方案2：用集合存选中店铺的唯一标识（不修改实体类时用） #

如果不想改动FShop，就在Adapter里定义一个集合，专门存选中店铺的id（比如shopId，必须是每个店铺唯一的）：

public class NearestShopAdapter extends RecyclerView.Adapter<MyHolder> {
    private List<FShop> shopList;
    private NearestShopActivityAdapterListener listener;
    // 存选中的店铺id
    private Set<String> selectedShopIds = new HashSet<>();

    // 其他构造、方法...
}

第三步：在onBindViewHolder里正确绑定选中状态 #

不管用哪个方案，必须在绑定数据的时候主动更新ImageView的状态，不能依赖ViewHolder的缓存，这是解决复用问题的关键：

用方案1的代码示例：

@Override
public void onBindViewHolder(@NonNull MyHolder holder, int position) {
    FShop currentShop = shopList.get(position);
    
    // 先绑定店铺的基础数据（比如名称、地址）
    holder.tvShopName.setText(currentShop.getShopName());
    // ...其他数据绑定

    // 关键：根据店铺的选中状态设置ImageView
    holder.ivSelected.setImageResource(
        currentShop.isSelected() ? R.drawable.ic_check_selected : R.drawable.ic_check_unselected
    );

    // 点击事件：切换选中状态
    holder.itemView.setOnClickListener(v -> {
        // 切换店铺的选中状态
        currentShop.setSelected(!currentShop.isSelected());
        // 立即更新视图
        holder.ivSelected.setImageResource(
            currentShop.isSelected() ? R.drawable.ic_check_selected : R.drawable.ic_check_unselected
        );
        // 回调给Activity处理后续逻辑
        listener.onShopSelected(currentShop, v);
    });
}

用方案2的代码示例：

@Override
public void onBindViewHolder(@NonNull MyHolder holder, int position) {
    FShop currentShop = shopList.get(position);
    
    holder.tvShopName.setText(currentShop.getShopName());
    // ...其他数据绑定

    // 关键：判断当前店铺id是否在选中集合里
    boolean isSelected = selectedShopIds.contains(currentShop.getShopId());
    holder.ivSelected.setImageResource(
        isSelected ? R.drawable.ic_check_selected : R.drawable.ic_check_unselected
    );

    // 点击事件：切换选中状态
    holder.itemView.setOnClickListener(v -> {
        if (isSelected) {
            selectedShopIds.remove(currentShop.getShopId());
        } else {
            selectedShopIds.add(currentShop.getShopId());
        }
        // 更新视图
        isSelected = !isSelected;
        holder.ivSelected.setImageResource(
            isSelected ? R.drawable.ic_check_selected : R.drawable.ic_check_unselected
        );
        listener.onShopSelected(currentShop, v);
    });
}

第四步：搜索刷新列表时保留选中状态 #

当你执行搜索逻辑，更新Adapter的数据源时，只要保证：

• 用方案1时：搜索筛选出的列表是原列表的子集（对象引用不变），那么isSelected状态会自动保留；
• 用方案2时：selectedShopIds集合不要清空，刷新列表后，onBindViewHolder会自动根据id匹配选中状态。

比如搜索的代码示例：

// 假设原列表是originalShopList，搜索关键词是searchKeyword
List<FShop> filteredShops = originalShopList.stream()
    .filter(shop -> shop.getShopName().contains(searchKeyword))
    .collect(Collectors.toList());

// 更新Adapter的数据源并刷新
adapter.setShopList(filteredShops);
adapter.notifyDataSetChanged();

最后检查点 #

• 确保每次绑定ViewHolder都主动设置ImageView的状态，不要只在点击事件里设置；
• 绝对不要用列表位置来记录选中状态，一定要和店铺的唯一标识或实体本身绑定。

这样修改后，不管是正常滚动还是搜索筛选，选中状态都能正确对应到你选的店铺啦～

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