Android中GridLayoutManager的spanCount设置无效问题求助

针对你遇到的RecyclerView设置GridLayoutManager(2)但仍显示单列的问题，可从以下几个方面排查并解决：

1. 移除XML中无效的属性 #

RecyclerView本身并不支持app:spanCount属性，该属性仅在通过代码配置GridLayoutManager时生效。因此可以直接删除XML中RecyclerView的app:spanCount="2"配置，它不会对布局产生任何影响。

2. 检查列表项布局的宽度设置 #

这是导致单列显示最常见的原因：如果列表项的根布局宽度设置为match_parent，每个item会直接占满整行，即使GridLayoutManager设置了spanCount=2也无法分成双列。

修改列表项布局（比如item_movie.xml）的根布局宽度：

<!-- 正确的宽度设置示例 -->
<androidx.cardview.widget.CardView xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="0dp"
    android:layout_height="wrap_content"
    android:layout_margin="8dp"
    app:layout_columnWeight="1"
    app:cardCornerRadius="8dp">

    <!-- 列表项内部控件 -->
</androidx.cardview.widget.CardView>

这里使用0dp + layout_columnWeight="1"让每个item平均分配列宽，也可以设置为wrap_content，GridLayoutManager会自动计算并分配合适的宽度。

3. 修正SpanSizeLookup的逻辑错误 #

你使用了moviesAdapter.withLoadStateFooter()，此时RecyclerView的实际Adapter是CombinedLoadStatesAdapter（包含原MoviesAdapter和底部加载状态Adapter）。直接调用moviesAdapter.getItemViewType(position)会导致位置不匹配——position对应的是CombinedAdapter的全局位置，而非原MoviesAdapter的内部位置，可能错误地将所有item判定为加载项，设置spanSize=2导致单列。

修改initRecyclerViewAndAdapter()中的SpanSizeLookup代码：

private void initRecyclerViewAndAdapter() {
    GridLayoutManager gridLayoutManager = new GridLayoutManager(this, 2);
    activityMainBinding.recyclerView.setLayoutManager(gridLayoutManager);
    activityMainBinding.recyclerView.addItemDecoration(new GridSpace(2, 20, true));
    // 保存CombinedAdapter引用
    RecyclerView.Adapter combinedAdapter = moviesAdapter.withLoadStateFooter(
            new MoviesLoadStateAdapter(view -> moviesAdapter.retry())
    );
    activityMainBinding.recyclerView.setAdapter(combinedAdapter);
    
    gridLayoutManager.setSpanSizeLookup(new GridLayoutManager.SpanSizeLookup() {
        @Override
        public int getSpanSize(int position) {
            int viewType = combinedAdapter.getItemViewType(position);
            // 底部加载状态项占满整行（spanSize=2），普通项占1列
            if (viewType == MoviesLoadStateAdapter.LOAD_STATE_VIEW_TYPE) {
                return 2;
            }
            return 1;
        }
    });
}

同时在MoviesLoadStateAdapter中添加唯一的viewType常量：

public class MoviesLoadStateAdapter extends LoadStateAdapter<MoviesLoadStateAdapter.LoadStateViewHolder> {
    // 定义全局唯一的加载状态viewType
    public static final int LOAD_STATE_VIEW_TYPE = 1001;

    // 构造方法及其他代码...

    @Override
    public int getItemViewType(int position) {
        return LOAD_STATE_VIEW_TYPE;
    }

    // ViewHolder及绑定逻辑...
}

4. 验证MoviesAdapter的viewType逻辑 #

如果你没有在MoviesAdapter内部自定义加载项，不需要返回LOADING_ITEM类型，因为Paging3的加载状态已经由LoadStateAdapter处理。保持MoviesAdapter的getItemViewType默认实现即可：

public class MoviesAdapter extends PagingDataAdapter<Movie, MoviesAdapter.MovieViewHolder> {
    // 移除不必要的LOADING_ITEM常量（如果没有自定义加载项）
    
    public MoviesAdapter(MovieComparator comparator, RequestManager requestManager) {
        super(comparator);
        // 初始化逻辑...
    }

    // 无需重写getItemViewType，使用父类默认实现即可
}

完成以上修改后，RecyclerView应该可以正常显示双列布局。

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