添加Toolbar后RecyclerView底部出现空白（AppBarLayout布局场景）

这个问题我做项目时也踩过坑，编辑器显示正常但真机出问题，大概率是布局参数配置不当或者组件高度计算偏差导致的，给你几个实用的排查和解决方向：

1. 确认RecyclerView的Behavior配置 #

这是最容易忽略的关键点：一定要给RecyclerView设置正确的滚动Behavior，让它和AppBarLayout联动，否则布局计算会完全混乱。

• 给RecyclerView添加属性：app:layout_behavior="@string/appbar_scrolling_view_behavior"
• 同时检查RecyclerView有没有多余的marginBottom或paddingBottom，有时候会因为Toolbar的高度被误加，导致底部留白。

2. 修正CollapsingToolbarLayout的高度与滚动配置 #

CollapsingToolbarLayout的高度设置不对是常见诱因：

• 不要用wrap_content作为它的高度，建议设固定值（比如250dp）或者match_parent，配合AppBarLayout的滚动Flags（比如scroll|exitUntilCollapsed），确保滚动时的高度计算准确。
• 检查Toolbar的高度配置：如果你的Toolbar里嵌套了自定义布局，要确认Toolbar的minHeight或layout_height没有被内部View异常撑大，否则会让RecyclerView的底部被“挤”出空白。

3. 调整RecyclerView与GridLayoutManager的细节 #

Grid布局本身的特性也可能导致底部留白：

• 给RecyclerView添加android:clipToPadding="false"，同时设置android:paddingBottom="?attr/actionBarSize"，这样滚动到底部时，列表内容能完全显示在屏幕内，不会被折叠后的Toolbar挡住（也不会留出空白）。
• 记得给RecyclerView调用setHasFixedSize(true)，让它提前计算好整体高度，避免动态布局带来的计算偏差。
• 检查列表项的CardView/LinearLayout：确保没有设置多余的底部margin或padding，尤其是嵌套布局里的，有时候这些小细节会累积成明显的空白。

4. 排查Toolbar内部滚动隐藏View的配置 #

你提到的滚动时隐藏的RelativeLayout，也要确认它的折叠模式正确：

• 给这个RelativeLayout添加app:layout_collapseMode="parallax"（视差滚动）或者none，如果模式设置错误，会导致AppBarLayout的整体高度计算出错，进而影响RecyclerView的布局位置。

参考示例布局 #

给你一个经过验证的布局结构，你可以对照调整自己的代码：

<androidx.coordinatorlayout.widget.CoordinatorLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <com.google.android.material.appbar.AppBarLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content">

        <com.google.android.material.appbar.CollapsingToolbarLayout
            android:layout_width="match_parent"
            android:layout_height="250dp"
            app:layout_scrollFlags="scroll|exitUntilCollapsed">

            <!-- 滚动时隐藏的RelativeLayout -->
            <RelativeLayout
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                app:layout_collapseMode="parallax">
                <!-- 你的滚动隐藏内容 -->
            </RelativeLayout>

            <androidx.appcompat.widget.Toolbar
                android:layout_width="match_parent"
                android:layout_height="?attr/actionBarSize"
                app:layout_collapseMode="pin">
                <!-- 固定的自定义布局 -->
                <LinearLayout
                    android:layout_width="match_parent"
                    android:layout_height="match_parent">
                    <!-- 你的固定内容 -->
                </LinearLayout>
            </androidx.appcompat.widget.Toolbar>

        </com.google.android.material.appbar.CollapsingToolbarLayout>
    </com.google.android.material.appbar.AppBarLayout>

    <androidx.recyclerview.widget.RecyclerView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:layout_behavior="@string/appbar_scrolling_view_behavior"
        android:clipToPadding="false"
        android:paddingBottom="?attr/actionBarSize"/>

</androidx.coordinatorlayout.widget.CoordinatorLayout>

如果以上方法都没解决，建议检查你的Material Components库版本，有些旧版本存在布局计算的bug，升级到最新稳定版应该能解决问题。

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