使用StaggeredGridLayoutManager时如何消除RecyclerView异常内边距？

问题表现 #

• RecyclerView采用StaggeredGridLayoutManager布局时，向下滚动后再向上回滚，会出现列表项排布错乱、出现异常多余内边距的问题
• 将gap策略设置为GAP_HANDLING_MOVE_ITEMS_BETWEEN_SPANS可以修复排布错乱，但会导致自定义ItemDecoration设置的内边距显示异常
• 效果参考：
  • 回滚前正常效果：
  • 回滚后异常效果：

问题根因 #

StaggeredGridLayoutManager默认的gap处理逻辑在回滚时会临时调整item的布局位置填补空白，当开启GAP_HANDLING_MOVE_ITEMS_BETWEEN_SPANS后，布局计算流程不会将ItemDecoration通过outRect设置的边距纳入偏移量计算，导致二次布局后边距累加、错位。

可落地修复方案 #

• 优先选无侵入方案：放弃使用GAP_HANDLING_MOVE_ITEMS_BETWEEN_SPANS策略，搭配滚动监听主动修正span分配

  1. 初始化布局管理器时设置gap策略为GAP_HANDLING_NONE
  2. 给RecyclerView添加滚动监听，在滚动停止时主动失效span缓存，触发布局重排
     代码示例：

  // Java版本示例
  StaggeredGridLayoutManager layoutManager = new StaggeredGridLayoutManager(2, StaggeredGridLayoutManager.VERTICAL);
  layoutManager.setGapStrategy(StaggeredGridLayoutManager.GAP_HANDLING_NONE);
  recyclerView.setLayoutManager(layoutManager);
  
  recyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() {
      @Override
      public void onScrollStateChanged(@NonNull RecyclerView recyclerView, int newState) {
          super.onScrollStateChanged(recyclerView, newState);
          if (newState == RecyclerView.SCROLL_STATE_IDLE) {
              layoutManager.invalidateSpanAssignments();
          }
      }
  });
  

  这个方案不会触发跨span移动item的逻辑，完全不会干扰ItemDecoration的边距计算，不会出现边距异常，同时能解决回滚错位的问题。

• 若业务必须使用GAP_HANDLING_MOVE_ITEMS_BETWEEN_SPANS策略：
  不要通过ItemDecoration设置item边距，改为在Adapter的onBindViewHolder流程中，直接给itemView设置对应的padding或者layout_margin，这类直接绑定在View上的布局参数会被StaggeredGridLayoutManager的计算逻辑正确识别，不会出现错位。
  额外注意：如果需要根据item所在列设置不同边距，不要直接用adapterPosition判断列号，要通过StaggeredGridLayoutManager.LayoutParams拿到真实的spanIndex再计算，避免重排过程中position和实际列不匹配导致边距错误。

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