RecyclerView偶现“失效”重叠项问题求助（Android 9及以上）

你的RecyclerView配置与相关代码 #

先梳理下你当前的实现代码：

XML布局

<androidx.recyclerview.widget.RecyclerView 
    android:scrollbars="vertical" 
    android:layout_width="match_parent" 
    android:layout_height="match_parent" 
    android:scrollbarThumbVertical="@android:color/transparent" 
    app:fastScrollEnabled="true" 
    app:fastScrollHorizontalThumbDrawable="@drawable/thumb_drawable" 
    app:fastScrollHorizontalTrackDrawable="@drawable/line_drawable" 
    app:fastScrollVerticalThumbDrawable="@drawable/thumb_drawable" 
    app:fastScrollVerticalTrackDrawable="@drawable/line_drawable"/>

Java逻辑代码

// Linear layout manager
LinearLayoutManager linearLayoutManager = new LinearLayoutManager(getContext());
recyclerView.setLayoutManager(layoutManager);
// Touch helper for scrolling
ItemTouchHelper touchHelper = new ItemTouchHelper(touchHelperCallback);
touchHelper.attachToRecyclerView(recyclerView);
// Simple adapter
MyAdapter adapter = new MyAdapter(myDataset);
recyclerView.setAdapter(adapter);

问题现象

每个列表项包含一个圆形控件，长按该控件后，界面会切换至仅允许选择其他项的状态。但偶现长按的项上会重叠一个无ViewModel数据的“失效”重复项，该项会停留在视图上，直到被滚出屏幕（推测是被回收后）才消失。此问题从Android 9开始出现。

看起来你遇到了一个和RecyclerView视图复用、状态强相关的棘手问题，而且只在Android 9及以上版本触发。结合现象（失效项回收后消失），下面是针对性的排查和解决思路：

1. 盯紧Adapter的视图复用与状态重置逻辑 #

Android 9（API 28）对RecyclerView的视图回收复用机制做了细微调整，尤其是状态切换时的视图清理逻辑。如果你的Adapter没有处理好视图复用的状态重置，很容易出现旧视图残留的情况：

• 检查是否正确实现了getItemViewType：如果选择状态和普通状态的UI差异较大，要给它们分配不同的viewType，避免RecyclerView跨状态复用视图；
• 强制在onBindViewHolder中重置所有状态相关的UI：不管视图是新创建的还是从回收池拿的，都要重新绑定ViewModel数据、设置控件的显示/隐藏、重置背景/elevation等，绝对不要依赖视图的默认状态（比如之前的选中状态）。

2. 排查长按状态切换时的视图层级操作 #

长按触发选择状态时，如果你直接操作了列表项的View（比如添加覆盖层、修改elevation），很可能在视图被回收时没清理这些操作，导致复用后出现重叠：

• 避免直接在ViewHolder的itemView上动态添加子View，建议通过Adapter维护一个selectedPositions集合，让onBindViewHolder统一根据集合状态渲染UI，这样视图复用时能自动重置；
• 如果用了elevation提升选中项层级，一定要在取消选择或视图复用时把elevation重置回默认值，防止旧视图的层级高于新绑定的视图，造成视觉重叠；
• 检查长按事件中是否有修改ViewGroup的clipChildren、clipToPadding属性，Android 9对这些属性的渲染逻辑有调整，可能导致视图超出父容器范围。

3. 验证ItemTouchHelper的交互冲突 #

你用到了ItemTouchHelper，它的触摸事件处理和RecyclerView的视图回收是深度绑定的，Android 9中它的回调时机可能有变化：

• 检查ItemTouchHelper.Callback中的onSelectedChanged、clearView方法，确保在视图状态变化时正确重置视图的状态（比如取消选中样式）；
• 暂时移除ItemTouchHelper，测试问题是否消失，以此排除它和长按选择逻辑的冲突；
• 确认长按触发选择时，是否同时触发了ItemTouchHelper的拖拽/滑动逻辑，导致视图被错误地标记为“正在使用”或状态未同步。

4. 确保ViewModel与数据集的一致性 #

失效项没有ViewModel数据，说明数据绑定环节出了问题：

• 检查长按状态切换时，是否修改了Adapter的数据集但没有正确通知RecyclerView更新：比如添加/移除项后，要调用notifyItemChanged(position)而非笼统的notifyDataSetChanged()，或者确保通知的position是正确的；
• 确保ViewModel的数据是线程安全的：如果长按操作涉及异步更新数据，要避免在视图绑定过程中数据集处于不一致状态；
• 在onBindViewHolder中添加日志，打印当前绑定的position和对应的ViewModel数据，出现问题时就能快速定位是否绑定了错误/空数据。

5. 跟踪RecyclerView回收池的行为 #

既然失效项滚出屏幕（被回收）后消失，那问题肯定和回收池脱不了干系：

• 临时测试：在状态切换时调用recyclerView.getRecycledViewPool().clear()清空回收池，看问题是否不再出现，如果是，说明回收的视图残留了旧状态；
• 自定义回收池：重写RecycledViewPool的getRecycledView或putRecycledView方法，添加日志跟踪视图的回收和复用情况，找到异常复用的具体时机；
• 开启setHasStableIds(true)：如果你的Adapter还没设置这个，尝试开启它，让RecyclerView能通过itemId识别每个项的唯一性，减少错误复用的概率。

6. 针对Android 9的特定适配 #

Android 9引入了一些视图渲染相关的变更，可能间接导致这个问题：

• 临时关闭硬件加速：在RecyclerView的布局中添加android:hardwareAccelerated="false"，测试是否是硬件加速的渲染bug导致的重叠；
• 查看Android 9的官方行为变更文档，重点关注RecyclerView、触摸事件、视图复用相关的调整，针对性地修改代码。

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