RecyclerView Selection库快速点击时点击穿透至自定义OnClickListener问题排查

这不是RecyclerView Selection库的Bug，而是你的配置导致了点击事件冲突——你自定义的OnClickListener会优先消费点击事件，而Selection库的SelectionTracker需要通过ItemDetailsLookup捕获事件来处理选中/取消选中逻辑。快速点击或双击时，自定义点击事件被优先触发，直接跳过了SelectionTracker的处理流程，就出现了你遇到的恼人问题。

核心冲突点 #

RecyclerView Selection库本身会监听item的点击/长按事件来管理选中状态，但你在ViewHolder中直接绑定的OnClickListener会拦截这些事件，导致SelectionTracker无法正常响应选择操作。

解决方案：区分选择模式与普通模式 #

我们需要调整点击事件的处理逻辑，让代码能判断当前是否处于「选择模式」（即有已选中的条目、ActionMode已开启），再决定走选择逻辑还是自定义点击逻辑：

1. 修改ViewHolder的点击事件与绑定逻辑

首先，在onBindViewHolder中把tracker传递给ViewHolder，让它能实时判断选择状态：

override fun onBindViewHolder(holder: UserViewHolder, position: Int) {
    val user = getItem(position)
    val tracker = tracker
    if (user != null && tracker != null) {
        // 新增传递tracker参数
        holder.bind(user, tracker.isSelected(user.uid), tracker)
    }
}

然后调整ViewHolder的代码，在点击时判断模式：

inner class UserViewHolder(private val binding: ItemUserListBinding) : RecyclerView.ViewHolder(binding.root) {
    private var tracker: SelectionTracker<String>? = null

    init {
        binding.root.setOnClickListener {
            val position = bindingAdapterPosition
            if (position != RecyclerView.NO_POSITION) {
                val item = getItem(position)
                // 判断是否处于选择模式（有已选中条目）
                val isInSelectionMode = tracker?.hasSelection() == true
                
                if (isInSelectionMode) {
                    // 选择模式下：让SelectionTracker处理选中/取消选中
                    tracker?.toggleSelection(item.uid)
                } else {
                    // 普通模式下：触发自定义点击逻辑
                    listener?.invoke(item)
                }
            }
        }
    }

    // 新增tracker参数，用于后续判断模式
    fun bind(user: User, isSelected: Boolean, tracker: SelectionTracker<String>) {
        this.tracker = tracker
        binding.apply {
            // 你的原有绑定逻辑
            root.isActivated = isSelected
        }
    }

    // getItemDetails方法保持不变
    fun getItemDetails() = object : ItemDetailsLookup.ItemDetails<String>() {
        override fun getPosition() = bindingAdapterPosition
        override fun getSelectionKey() = getItem(bindingAdapterPosition).uid
    }
}

2. 确保ItemDetailsLookup正常工作

你的DetailsLookup实现是正确的，它能帮助SelectionTracker获取点击位置的条目信息，这个部分不需要修改。

3. 验证ActionMode状态同步

你的SelectionObserver逻辑已经能正确开启/关闭ActionMode，这会保证tracker.hasSelection()的判断准确，无需额外调整。

效果说明 #

调整后：

• 当没有选中任何条目（普通模式）：点击item会触发你的自定义onUserClick逻辑
• 当已有选中条目（选择模式）：点击item会切换选中/取消选中状态，不会触发自定义点击
• 快速点击或双击时，也会根据当前模式执行对应逻辑，不会再出现事件混乱的情况

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