RecyclerView滚动时条目忽隐忽现问题排查咨询

嘿，这个问题我在开发中碰到过好多次，RecyclerView滚动时条目莫名消失又重新出现，大概率是下面这些原因，咱们一个个来捋：

1. ViewHolder复用导致的状态未重置（最常见！） #

RecyclerView的核心就是ViewHolder复用，如果你在onBindViewHolder里没有完整绑定所有状态，就会带上上个条目的“遗留状态”，导致显示异常。

举个例子：假设你的列表里有些条目需要隐藏某个View，错误的写法是只在需要隐藏时设置，却没在不需要隐藏时重置：

// 错误示例：只处理隐藏情况，忽略显示情况
@Override
public void onBindViewHolder(ViewHolder holder, int position) {
    Item item = mDataList.get(position);
    if (item.isHideContent()) {
        holder.contentView.setVisibility(View.GONE);
    }
}

当这个ViewHolder被复用到需要显示内容的条目时，contentView还是GONE状态，看起来就像条目“消失”了。正确的做法是明确设置所有可能的状态：

// 正确示例：无论什么情况都明确设置状态
@Override
public void onBindViewHolder(ViewHolder holder, int position) {
    Item item = mDataList.get(position);
    holder.contentView.setVisibility(item.isHideContent() ? View.GONE : View.VISIBLE);
    // 其他视图的状态也要同理，比如文本、图片等都要重新绑定，不能复用旧值
}

2. 数据源或更新方式出错 #

如果滚动时数据源被频繁修改，或者更新列表的方式不对，也会导致条目显示异常：

• 有没有在异步操作中直接修改数据源，然后未正确通知RecyclerView？比如在子线程更新数据后，要确保在主线程调用notifyItemXXX()系列方法（别乱用notifyDataSetChanged()，它会强制刷新所有可见条目，容易导致闪屏）。
• 检查getItemCount()的返回值是否和数据源实际大小一致。如果数据源大小变了，但getItemCount()没同步，RecyclerView会计算错误的条目数量，滚动时就会出现条目“消失”的假象。

3. 布局或ItemDecoration的问题 #

布局参数或ItemDecoration的错误也可能导致条目位置计算异常：

• 检查Item布局的根View是否用了正确的布局参数，比如如果用wrap_content但实际测量高度计算错误，滚动时条目可能被挤出屏幕又重新出现。
• 自定义的ItemDecoration有没有错误设置偏移量？比如getItemOffsets()返回的值在不同位置不一致，或者动态修改偏移导致布局混乱。
• 试试更换默认的LayoutManager（比如从自定义LayoutManager换成LinearLayoutManager），排除布局管理器的问题。

4. Item动画的干扰 #

RecyclerView默认的Item动画或者自定义动画，有时候会和滚动冲突，导致条目闪屏：
你可以先暂时关闭Item动画测试：

recyclerView.setItemAnimator(null);

如果关闭后问题消失，那就是动画的锅。可以调整动画时长，或者自定义更兼容的ItemAnimator，避免滚动时动画未完成导致的显示异常。

5. 内存或性能问题（概率较低） #

如果你的Item布局非常复杂，或者加载了大量未缓存的图片，系统会频繁回收ViewHolder，滚动时重新创建，看起来就像条目消失又出现：

• 用图片加载库（如Glide、Coil）做好图片缓存，避免重复加载。
• 优化Item布局的层级，减少过度绘制，比如用<merge>标签减少布局嵌套，或者用ViewStub延迟加载复杂视图。

6. 多线程更新UI的问题 #

一定要确保所有涉及RecyclerView数据更新和UI操作都在主线程执行！如果在子线程直接修改数据源并调用通知方法，会导致数据和UI不同步，出现各种奇怪的显示问题。可以用runOnUiThread()或者Handler.post()来切换到主线程操作。

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