EndlessRecyclerView随机出现IndexOutOfBoundsException异常如何解决？

该IndexOutOfBoundsException是RecyclerView的经典状态不一致崩溃，触发根源是Adapter绑定的内存数据集和RecyclerView已渲染的布局状态不匹配，结合使用的EndlessRecyclerView带加载更多占位项的特性，常见触发场景如下：

• 子线程修改了Adapter绑定的数据源，未及时在主线程调用对应notify方法，RecyclerView的GapWorker预取逻辑先执行，获取ViewHolder时发现位置和实际数据集大小不匹配
• 加载更多逻辑中，新增/移除底部Progress占位项时，notify调用的位置参数和实际数据集大小不匹配，比如先修改了数据集再计算占位项位置，或者反过来
• 下拉刷新和上拉加载更多逻辑同时触发，两个线程同时修改数据源且notify调用顺序错乱，导致状态同步失败

之前重写onLayoutChildren捕获异常无效的原因是，本次崩溃发生在RecyclerView的预取工作线程GapWorker中，并非布局方法内抛出，所以捕获不生效。

临时止崩方案 #

直接关闭RecyclerView的预取功能，从触发路径上规避崩溃，该方案改动最小，对用户体验的影响几乎可以忽略：
自定义LinearLayoutManager时新增如下配置：

// 关闭预取动画
@Override
public boolean supportsPredictiveItemAnimations() {
    return false;
}

// 空实现预取位置收集逻辑，禁用GapWorker预取
@Override
public void collectAdjacentPrefetchPositions(int dx, int dy, RecyclerView.State state, @NonNull LayoutPrefetchRegistry registry) {
    
}

根因修复方案 #

针对EndlessRecyclerView的逻辑做如下整改：

• 所有对Adapter数据集的修改操作、对应的notify系列方法调用，必须放到主线程执行，且保证修改数据集和调用notify为原子操作，中间不允许插入其他修改数据集的逻辑
• 加载更多占位项的增删逻辑加防御判断：
  • 新增占位项时，先取当前真实数据集的大小作为插入位置，调用notifyItemInserted后再将占位项添加到数据集末尾
  • 移除占位项时，先判断数据集最后一条是否为占位项，确认位置后先删除数据集内的占位项，再调用notifyItemRemoved
• 给下拉刷新和上拉加载更多添加互斥标识，刷新过程中禁止触发加载更多，加载更多未完成前禁止触发刷新，避免两个逻辑同时修改数据源
• 调用notify方法前增加状态判断，如果RecyclerView正处于布局计算或滚动状态，就将notify操作post到主线程消息队列末尾，等布局结束后再执行

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