水平RecyclerView更新时报Tmp detached view相关随机崩溃

云上老周

2026-8-28

崩溃核心原因

这个崩溃是RecyclerView内部的状态校验抛出的：当ViewHolder处于tmpDetached（布局/动画过程中临时分离、暂存在RecyclerView内部临时队列）状态时，回收流程会校验该View是否已经被正确从临时队列移除、完成和父容器的状态同步，校验不通过就会直接抛出题目中的异常。该问题和RecyclerView是水平/垂直方向没有直接关联，本质是View管理流程、数据更新流程的时序冲突，常见触发场景包括：

数据更新操作没有严格在主线程执行，或者更新时机刚好撞上RecyclerView滚动、布局、Item动画执行的中间状态，内部View状态还没同步完成就触发了回收逻辑
自定义LayoutManager、ItemAnimator、嵌套滚动父容器存在逻辑缺陷：将View加入临时分离队列后，没有在布局流程结束时正确把View重新挂载或者从临时队列移除，打乱了内部的View状态记录
DiffUtil/ListAdapter使用不规范：Diff计算过程中原始数据集被篡改、areItemsTheSame/areContentsTheSame返回逻辑错误，导致item位置映射关系错乱，回收时匹配不到正确的View依附状态
违规直接操作RecyclerView子View：比如在onBindViewHolder、子View点击事件里直接调用RecyclerView的add/removeView方法，或者在绑定阶段做会触发RecyclerView立即重布局的操作，破坏内部View管理栈
没有给Adapter设置稳定ID，大量局部刷新时item位置匹配出错，崩溃日志里显示的id=-1就是未配置稳定ID的默认表现

排查方向

先全量排查所有Adapter数据更新逻辑：遍历所有调用notifyDataSetChanged、notifyItem*、submitList的位置，确认所有调用都发生在主线程，网络请求回调必须先切到主线程再执行数据更新操作，禁止子线程访问Adapter或RecyclerView的任何方法
缩小自定义组件范围：如果用了自定义LayoutManager、第三方ItemAnimator、和横向滑动冲突的嵌套容器（比如和ViewPager2、横向滑动父布局联动的场景），先临时替换为系统原生LinearLayoutManager、默认DefaultItemAnimator，运行一段时间看崩溃是否复现，定位是否是自定义组件逻辑问题
打印时序日志定位冲突：在每次触发数据更新、RecyclerView的onLayout回调、onScrollStateChanged回调里打日志标记状态，确认崩溃前是否存在「滚动/布局未完成就触发数据刷新」的时序问题，比如用户滑动过程中刚好网络请求返回触发列表刷新
校验数据一致性：如果用了DiffUtil，确认传入Diff计算的旧数据集是完全只读的，Diff计算和提交的整个过程中，不要修改当前正在被RecyclerView渲染的数据集，避免Diff计算的位置信息和实际渲染数据不匹配

可行解决建议

增加更新时机校验：所有触发列表数据更新的逻辑执行前，先判断RecyclerView是否处于空闲状态，非空闲状态就延迟到下一个UI消息周期再更新，示例代码：

fun safeUpdateList(recyclerView: RecyclerView, newData: List<Any>) {
    if (recyclerView.isComputingLayout || recyclerView.scrollState != RecyclerView.SCROLL_STATE_IDLE) {
        recyclerView.post { safeUpdateList(recyclerView, newData) }
        return
    }
    // 执行实际的adapter更新、submitList等操作
    adapter.submitList(newData)
}

配置稳定ID：给Adapter调用setHasStableIds(true)，并重写getItemId方法返回每个item的全局唯一标识（不要返回固定值或者position），减少局部刷新时的位置匹配错误
规范ListAdapter使用：每次调用submitList时传入新的列表实例，不要直接修改原有列表对象后提交；短时间内有多次更新请求时，只保留最后一次更新操作，避免连续提交导致的状态错乱
禁用异常动画验证：如果排查怀疑是Item动画导致的状态异常，可以临时设置recyclerView.itemAnimator = null验证，确认是动画问题后替换为逻辑可靠的动画实现，不要用存在已知bug的老旧第三方动画库

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