RecyclerView ItemAnimator移动项层级问题：自定义动画后滚动崩溃

问题根源 #

你调用bringToFront()的操作会破坏RecyclerView ItemAnimator的内部视图状态管理逻辑——ItemAnimator在处理动画时会自行维护视图的隐藏/显示标记，而bringToFront()直接修改了视图层级，导致滚动时ItemAnimator试图对一个未被它标记为隐藏的视图执行"取消隐藏"操作，最终抛出异常。

替代方案：用translationZ控制动画层级 #

不要直接修改视图树结构，而是通过临时提升translationZ（视图的Z轴偏移量）让上移的item在动画期间显示在最上层，动画结束后恢复原状态，完全不会干扰RecyclerView的内部视图管理机制。

自定义ItemAnimator实现代码 #

class CustomMoveAnimator : DefaultItemAnimator() {
    override fun animateMove(
        holder: RecyclerView.ViewHolder,
        fromX: Int,
        fromY: Int,
        toX: Int,
        toY: Int
    ): Boolean {
        val isMovingUp = fromY > toY
        // 上移的item临时提升Z轴，确保动画期间在视觉层级最上层
        if (isMovingUp) {
            holder.itemView.translationZ = 10f
        }

        // 执行默认的移动动画逻辑
        val animateResult = super.animateMove(holder, fromX, fromY, toX, toY)

        // 动画结束后恢复Z轴偏移，避免影响后续列表交互
        holder.itemView.animate().setListener(object : Animator.AnimatorListener {
            override fun onAnimationStart(animation: Animator?) = Unit
            override fun onAnimationEnd(animation: Animator?) {
                holder.itemView.translationZ = 0f
                // 移除监听防止内存泄漏
                holder.itemView.animate().setListener(null)
            }
            override fun onAnimationCancel(animation: Animator?) {
                holder.itemView.translationZ = 0f
                holder.itemView.animate().setListener(null)
            }
            override fun onAnimationRepeat(animation: Animator?) = Unit
        })

        return animateResult
    }
}

使用方式 #

在RecyclerView初始化时设置这个自定义动画器即可：

recyclerView.itemAnimator = CustomMoveAnimator()

方案优势 #

• translationZ仅临时改变视图的视觉层级，不会修改View树的实际结构，完全兼容RecyclerView的视图池和ItemAnimator管理逻辑。
• 动画结束后恢复translationZ为0，不会影响后续的列表滚动、视图复用等操作，彻底规避了崩溃问题。

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