RecyclerView滚动/滑动删除元素后触发onLongClick异常的问题与解决方法

这种滑动删除后误触发长按的问题我之前帮开发者排查过好多次，核心是手势识别和RecyclerView布局更新的冲突导致的，咱们来一步步拆解原因和解决办法：

问题原因 #

• 触摸事件未及时终止：当你滑动删除第一个Item时，触摸手势还没完全结束，RecyclerView就完成了布局更新（剩下的Item自动上移），此时GestureDetector还在跟踪之前的触摸序列，会把后续的触摸动作误判为长按事件。
• 动画期间的触摸干扰：RecyclerView默认的Item删除动画（比如DefaultItemAnimator）会占用一定时间，在动画执行过程中，RecyclerView的触摸事件传递逻辑出现混乱，导致新的第一个Item（原第二个Item）接收到了未正确终止的长按手势信号。
• 手势处理逻辑有漏洞：你的RecyclerTouchListener可能没有正确处理ACTION_CANCEL或ACTION_UP事件，导致手势状态没有及时重置。

解决方案 #

方案1：删除Item时主动重置手势状态 #

在执行删除操作后，给GestureDetector传入一个ACTION_CANCEL事件，强制终止当前的手势跟踪：

// 假设这是你的删除方法
public void deleteItem(int position) {
    // 执行删除逻辑
    mDataList.remove(position);
    mAdapter.notifyItemRemoved(position);
    
    // 生成一个ACTION_CANCEL事件，重置GestureDetector
    MotionEvent cancelEvent = MotionEvent.obtain(System.currentTimeMillis(), System.currentTimeMillis(), MotionEvent.ACTION_CANCEL, 0, 0, 0);
    mRecyclerTouchListener.getGestureDetector().onTouchEvent(cancelEvent);
    cancelEvent.recycle();
}

注意：需要给RecyclerTouchListener添加一个获取gestureDetector的公开方法，或者直接在内部封装重置逻辑。

方案2：拦截动画期间的触摸事件 #

在RecyclerTouchListener的onInterceptTouchEvent方法中，判断RecyclerView是否正在执行动画，如果是就直接拦截事件，避免手势误判：

@Override
public boolean onInterceptTouchEvent(@NonNull RecyclerView rv, @NonNull MotionEvent e) {
    // 如果RecyclerView有正在运行的动画，拦截所有触摸事件
    if (rv.getItemAnimator() != null && rv.getItemAnimator().isRunning()) {
        return true;
    }
    return gestureDetector.onTouchEvent(e);
}

方案3：完善GestureDetector的长按触发逻辑 #

给GestureDetector添加一个“删除中”的标记，在删除操作期间禁用长按触发：

// 在RecyclerTouchListener的构造方法中修改GestureDetector的逻辑
gestureDetector = new GestureDetector(context, new GestureDetector.SimpleOnGestureListener() {
    private boolean isDeleting = false;

    @Override
    public void onLongPress(MotionEvent e) {
        // 如果正在删除，直接跳过长按逻辑
        if (isDeleting) return;
        
        // 原本的长按处理逻辑
        View child = recyclerView.findChildViewUnder(e.getX(), e.getY());
        if (child != null && clickListener != null) {
            clickListener.onLongClick(child, recyclerView.getChildAdapterPosition(child));
        }
    }

    // 公开方法用于设置删除状态
    public void setDeleting(boolean deleting) {
        this.isDeleting = deleting;
    }
});

然后在删除操作时配合动画监听重置标记：

public void deleteItem(int position) {
    mRecyclerTouchListener.getGestureDetector().setDeleting(true);
    mDataList.remove(position);
    mAdapter.notifyItemRemoved(position);
    
    // 监听动画结束，重置删除标记
    mRecyclerView.getItemAnimator().addListener(new Animator.AnimatorListener() {
        @Override
        public void onAnimationStart(Animator animation) {}

        @Override
        public void onAnimationEnd(Animator animation) {
            mRecyclerTouchListener.getGestureDetector().setDeleting(false);
            mRecyclerView.getItemAnimator().removeListener(this);
        }

        @Override
        public void onAnimationCancel(Animator animation) {
            mRecyclerTouchListener.getGestureDetector().setDeleting(false);
            mRecyclerView.getItemAnimator().removeListener(this);
        }

        @Override
        public void onAnimationRepeat(Animator animation) {}
    });
}

方案4：用官方ItemTouchHelper实现滑动删除（最推荐） #

官方的ItemTouchHelper已经完美处理了手势冲突和布局更新的问题，完全不会出现这种误触发的情况，直接替换你的自定义滑动逻辑即可：

// 创建滑动删除的Callback
ItemTouchHelper.SimpleCallback swipeCallback = new ItemTouchHelper.SimpleCallback(0, ItemTouchHelper.LEFT | ItemTouchHelper.RIGHT) {
    @Override
    public boolean onMove(@NonNull RecyclerView recyclerView, @NonNull RecyclerView.ViewHolder viewHolder, @NonNull RecyclerView.ViewHolder target) {
        return false; // 不需要拖拽排序，返回false
    }

    @Override
    public void onSwiped(@NonNull RecyclerView.ViewHolder viewHolder, int direction) {
        // 执行删除逻辑
        int position = viewHolder.getAdapterPosition();
        mDataList.remove(position);
        mAdapter.notifyItemRemoved(position);
    }
};

// 绑定到RecyclerView
ItemTouchHelper itemTouchHelper = new ItemTouchHelper(swipeCallback);
itemTouchHelper.attachToRecyclerView(mRecyclerView);

内容的提问来源于stack exchange，提问作者Антон Лялин