RecyclerView卡片首次点击需两次才触发Checkbox选中问题求助

第一步：简化布局，移除多余的可点击/可聚焦设置 #

布局里嵌套多层可点击View会导致事件分发混乱，首次点击的事件可能被上层View消耗，直接移除所有非必要的android:clickable="true"和android:focusable="true"属性，同时去掉冗余的内层CardView：

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_marginVertical="@dimen/half_default_size"
    android:background="@drawable/team_member_rounded">

    <androidx.cardview.widget.CardView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:cardCornerRadius="@dimen/half_default_size"
        app:cardElevation="4dp">

        <androidx.constraintlayout.widget.ConstraintLayout
            android:id="@+id/members_card"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:padding="@dimen/default_size">

            <androidx.constraintlayout.widget.ConstraintLayout
                android:id="@+id/cl_checkbox"
                android:layout_width="match_parent"
                android:layout_height="match_parent">

                <CheckBox
                    android:id="@+id/checkbox_member"
                    android:layout_width="wrap_content"
                    android:layout_height="wrap_content"
                    app:layout_constraintBottom_toBottomOf="parent"
                    app:layout_constraintStart_toStartOf="parent"
                    app:layout_constraintTop_toTopOf="parent" />

                <TextView
                    android:id="@+id/text_member_name"
                    style="@style/TextAppearance.AppCompat.Body1"
                    android:layout_width="wrap_content"
                    android:layout_height="wrap_content"
                    android:layout_marginStart="@dimen/half_default_size"
                    android:ellipsize="end"
                    android:maxLines="1"
                    app:layout_constraintBottom_toBottomOf="parent"
                    app:layout_constraintStart_toEndOf="@id/checkbox_member"
                    app:layout_constraintTop_toTopOf="parent"
                    tools:text="C012345 TESTE" />

            </androidx.constraintlayout.widget.ConstraintLayout>

        </androidx.constraintlayout.widget.ConstraintLayout>

    </androidx.cardview.widget.CardView>

</layout>

第二步：统一点击事件逻辑，避免重复触发 #

只保留CheckBox和itemView的点击事件，将状态切换逻辑抽成统一方法，避免多次触发导致状态混乱：

// 初始化CheckBox选中状态
holder.checkBox.setChecked(membersSelected.contains(agent));

// 定义统一的状态切换逻辑
Runnable toggleSelection = () -> {
    if (membersSelected.contains(agent)) {
        membersSelected.remove(agent);
    } else {
        membersSelected.add(agent);
    }
    // 同步UI状态
    holder.checkBox.setChecked(membersSelected.contains(agent));
    // 如需刷新列表，可调用：notifyItemChanged(holder.getAdapterPosition());
};

// CheckBox自身点击事件
holder.checkBox.setOnClickListener(view -> toggleSelection.run());

// 整个卡片区域点击事件
holder.itemView.setOnClickListener(view -> toggleSelection.run());

问题根源说明 #

1. 多层可点击View会拦截点击事件，首次点击被上层View消耗，第二次点击才会传递到目标逻辑；
2. 重复绑定多个View的点击事件，且在itemView中触发多次performClick，会导致状态被连续反转多次，首次点击后回到初始状态，看起来像是未生效，第二次点击才会切换到正确状态。

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