Android开发：为分页加载的RecyclerView添加底部进度条

结合你描述的场景，我猜你大概率遇到了这类常见问题：进度条滚动时跟着RecyclerView一起被滑走、加载时重复触发显示、或者数据加载完成后无法正确隐藏？下面给你几个针对性的解决方案：

1. 更优雅的方案：把进度条作为RecyclerView的Footer Item #

固定在布局底部的进度条很容易出现显示时机不对、滚动遮挡的问题，更推荐把进度条作为RecyclerView的最后一个Item（Footer），这样它会自然跟随列表滚动，体验更流畅：

实现步骤： #

• 首先在Adapter里定义两种Item类型：

  private static final int TYPE_NORMAL_ITEM = 0;
  private static final int TYPE_LOAD_FOOTER = 1;
  private boolean isLoading = false; // 标记是否正在加载
  private boolean hasMoreData = true; // 标记是否还有更多数据
  

• 重写getItemViewType()，判断是否要显示Footer：

  @Override
  public int getItemViewType(int position) {
      // 如果是最后一个位置，且正在加载、还有更多数据，返回Footer类型
      return (position == getItemCount() - 1 && isLoading && hasMoreData) ? TYPE_LOAD_FOOTER : TYPE_NORMAL_ITEM;
  }
  

• 在onCreateViewHolder()中加载对应布局：

  @Override
  public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
      LayoutInflater inflater = LayoutInflater.from(parent.getContext());
      if (viewType == TYPE_NORMAL_ITEM) {
          // 加载你的普通Item布局
          View itemView = inflater.inflate(R.layout.your_normal_item_layout, parent, false);
          return new NormalItemViewHolder(itemView);
      } else {
          // 加载进度条Footer布局
          View footerView = inflater.inflate(R.layout.item_loading_footer, parent, false);
          return new LoadingFooterViewHolder(footerView);
      }
  }
  

• 调整getItemCount()，加载状态下多算一个Footer位置：

  @Override
  public int getItemCount() {
      return dataList.size() + (isLoading && hasMoreData ? 1 : 0);
  }
  

2. 修复固定布局进度条的显示问题 #

如果你坚持使用固定在RecyclerView下方的进度条，要注意这几个细节：

• 布局结构要正确，确保RecyclerView不会覆盖进度条：
  比如用ConstraintLayout实现：

  <androidx.constraintlayout.widget.ConstraintLayout
      xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:app="http://schemas.android.com/apk/res-auto"
      android:layout_width="match_parent"
      android:layout_height="match_parent">
  
      <androidx.recyclerview.widget.RecyclerView
          android:id="@+id/recyclerView"
          android:layout_width="match_parent"
          android:layout_height="0dp"
          app:layout_constraintTop_toTopOf="parent"
          app:layout_constraintBottom_toTopOf="@+id/loadingProgress"/>
  
      <ProgressBar
          android:id="@+id/loadingProgress"
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:visibility="gone"
          app:layout_constraintBottom_toBottomOf="parent"
          app:layout_constraintLeft_toLeftOf="parent"
          app:layout_constraintRight_toRightOf="parent"/>
  </androidx.constraintlayout.widget.ConstraintLayout>
  

• 滚动监听逻辑要严谨，避免重复触发加载：

  recyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() {
      @Override
      public void onScrolled(@NonNull RecyclerView recyclerView, int dx, int dy) {
          super.onScrolled(recyclerView, dx, dy);
          LinearLayoutManager layoutManager = (LinearLayoutManager) recyclerView.getLayoutManager();
          // 确保只有在未加载、还有数据、且滚动到最后一个可见Item时才触发加载
          if (!isLoading && hasMoreData && 
              layoutManager.findLastCompletelyVisibleItemPosition() == dataList.size() - 1) {
              isLoading = true;
              loadingProgress.setVisibility(View.VISIBLE);
              loadNextPageData();
          }
      }
  });
  

• 加载完成/失败后必须重置状态：

  private void loadNextPageData() {
      yourApiService.getNextPage(currentPage)
          .enqueue(new Callback<DataResponse>() {
              @Override
              public void onResponse(Call<DataResponse> call, Response<DataResponse> response) {
                  if (response.isSuccessful()) {
                      dataList.addAll(response.body().getData());
                      yourAdapter.notifyDataSetChanged();
                      currentPage++;
                      hasMoreData = response.body().isHasMore();
                  }
                  // 无论成功失败，都重置加载状态并隐藏进度条
                  isLoading = false;
                  loadingProgress.setVisibility(View.GONE);
              }
  
              @Override
              public void onFailure(Call<DataResponse> call, Throwable t) {
                  isLoading = false;
                  loadingProgress.setVisibility(View.GONE);
                  // 这里可以添加加载失败的提示
              }
          });
  }
  

3. 常见坑点排查 #

• 不要忽略加载失败的情况：如果API请求失败，一定要把isLoading设为false，否则进度条会一直显示，也无法触发下一次加载。
• 避免重复请求：必须用isLoading标志位控制，防止用户快速滚动时多次触发加载。
• 如果是GridLayoutManager，判断底部的逻辑要调整：可以用findLastVisibleItemPosition()结合列数来判断是否滚动到列表底部。

内容的提问来源于stack exchange，提问作者vidu.sh