RecyclerView列表项快速更新时点击事件失效问题排查

嘿，这个问题我之前做BLE扫描应用时也踩过坑！核心问题大概率是扫描过程中RecyclerView的数据源频繁刷新，导致视图状态不稳定，点击事件被干扰甚至吞掉，给你几个针对性的排查和解决方向：

BLE扫描的回调是在工作线程触发的，如果扫到一个设备就立刻调用notifyDataSetChanged()，RecyclerView会疯狂刷新，视图还没完成绑定就被重新渲染，点击事件自然无法正常响应。

解决思路是：把扫描到的设备先存入线程安全的集合，然后在主线程批量延迟更新，比如每隔500ms刷新一次Adapter：

// 线程安全的设备存储集合，用地址去重
private val scannedDevices = ConcurrentHashMap<String, BluetoothDevice>()
private val mainHandler = Handler(Looper.getMainLooper())
private var updateRunnable: Runnable? = null

// BLE扫描回调
override fun onScanResult(callbackType: Int, result: ScanResult) {
    super.onScanResult(callbackType, result)
    // 先把设备存入集合去重
    scannedDevices[result.device.address] = result.device
    
    // 取消之前的延迟任务，避免重复刷新
    updateRunnable?.let { mainHandler.removeCallbacks(it) }
    updateRunnable = Runnable {
        // 主线程更新Adapter数据
        deviceAdapter.submitList(scannedDevices.values.toList())
    }
    // 延迟500ms刷新，平衡实时性和稳定性
    mainHandler.postDelayed(updateRunnable!!, 500)
}

如果CardView内部有Button、CheckBox这类默认可点击的控件，它们会抢占CardView的点击焦点，导致外层CardView无法响应点击。

解决方法：

• 在CardView的布局中添加android:descendantFocusability="blocksDescendants"，让CardView优先接收点击事件：

<androidx.cardview.widget.CardView
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:clickable="true"
    android:focusable="true"
    android:descendantFocusability="blocksDescendants">

    <!-- 内部子控件 -->
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="设备名称"/>

</androidx.cardview.widget.CardView>

• 如果不需要内部控件单独响应点击，也可以把它们的android:focusable="false"、android:clickable="false"。

默认的ItemAnimator在频繁刷新时会执行入场/变更动画，动画过程中视图的点击事件可能被临时禁用。

可以尝试关闭动画，或者禁用变更动画：

// 直接关闭所有Item动画
recyclerView.itemAnimator = null

// 或者保留基础动画，禁用变更动画
val animator = SimpleItemAnimator()
animator.supportsChangeAnimations = false
recyclerView.itemAnimator = animator

如果在onBindViewHolder里重复设置setOnClickListener，会导致ViewHolder复用后点击事件多次绑定，逻辑混乱。正确的做法是在ViewHolder的构造函数里初始化点击事件：

class DeviceViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
    init {
        // 在这里绑定点击事件，只执行一次
        itemView.setOnClickListener {
            val position = adapterPosition
            if (position != RecyclerView.NO_POSITION) {
                val device = deviceList[position]
                // 发起设备连接的逻辑
            }
        }
    }

    // 只在onBindViewHolder里更新视图数据
    fun bind(device: BluetoothDevice) {
        itemView.deviceNameTv.text = device.name ?: "未知设备"
        itemView.deviceAddressTv.text = device.address
    }
}

优先从数据源更新频率入手排查，这是这类问题最常见的诱因，然后依次检查触摸拦截、动画和点击绑定逻辑，应该就能解决扫描时点击无响应的问题了。

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