ItemTouchHelper拖动视图的SimpleCallback失效，RecyclerView拖动时无法上下滚动

问题根源 #

你的RecyclerView被嵌套在NestedScrollView中，且高度设为wrap_content，这会导致两个核心问题：

• NestedScrollView会拦截RecyclerView的滚动事件，压制其自身的滚动机制
• ItemTouchHelper的拖动手势与NestedScrollView的滚动手势产生冲突，导致拖动时无法正常触发列表滚动

解决方案 #

1. 移除不必要的NestedScrollView嵌套（优先推荐）

如果RecyclerView是布局中的主要滚动容器，直接去掉NestedScrollView，让RecyclerView自行处理滚动和拖动逻辑。修改后的XML布局：

<LinearLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">
    
    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/rvDraggable"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_marginStart="@dimen/dp_16"
        android:layout_marginEnd="@dimen/dp_16"
        app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/cardViewSeatWise" />
</LinearLayout>

这里将RecyclerView的高度改为match_parent，让它占据剩余布局空间，完全接管滚动逻辑。

2. 必须保留NestedScrollView时的处理

如果布局需求必须保留NestedScrollView，按以下步骤调整：

• 给RecyclerView添加属性，禁用其嵌套滚动：

  <androidx.recyclerview.widget.RecyclerView
      ...
      android:nestedScrollingEnabled="false" />
  

• 在ItemTouchHelper的onMove方法中手动处理边缘滚动，确保拖动到列表边界时触发滚动：

  @Override
  public boolean onMove(@NonNull RecyclerView recyclerView, @NonNull RecyclerView.ViewHolder viewHolder, @NonNull RecyclerView.ViewHolder target) {
      int fromPos = viewHolder.getAdapterPosition();
      int toPos = target.getAdapterPosition();
      // 交换数据源中的数据
      Collections.swap(yourDataList, fromPos, toPos);
      yourAdapter.notifyItemMoved(fromPos, toPos);
      
      // 手动触发边缘滚动
      LinearLayoutManager layoutManager = (LinearLayoutManager) recyclerView.getLayoutManager();
      if (layoutManager != null) {
          int firstVisible = layoutManager.findFirstVisibleItemPosition();
          int lastVisible = layoutManager.findLastVisibleItemPosition();
          
          // 拖动到顶部边缘，向上滚动
          if (toPos <= firstVisible && toPos > 0) {
              recyclerView.smoothScrollToPosition(toPos - 1);
          }
          // 拖动到底部边缘，向下滚动
          else if (toPos >= lastVisible && toPos < yourDataList.size() - 1) {
              recyclerView.smoothScrollToPosition(toPos + 1);
          }
      }
      return true;
  }
  

• 确保Adapter的Item布局高度设置合理，避免RecyclerView因高度计算错误导致滚动异常。

3. 验证ItemTouchHelper的拖动方向配置

确认SimpleCallback的构造方法正确设置了垂直拖动方向：

ItemTouchHelper.SimpleCallback touchCallback = new ItemTouchHelper.SimpleCallback(ItemTouchHelper.UP | ItemTouchHelper.DOWN, 0) {
    // 实现onMove、onSwiped等方法
};

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