Android自定义Toolbar设置背景后滚动遮挡SearchView如何解决

两个连续异常均为View绘制层级、联动属性配置错误导致：

• 滚动内容穿透：CollapsingToolbarLayout折叠状态默认无独立不透明背景，若Toolbar本身未配置不透明背景，z轴绘制优先级低于滚动的NestedScrollView内容，就会出现列表内容透到Toolbar下方的问题
• SearchView被白色背景遮挡：直接给Toolbar设置纯白色背景时，Toolbar的背景层绘制优先级高于未正确配置z轴、布局位置错误的SearchView，折叠状态下SearchView会被背景层完全覆盖

• 调整背景配置逻辑，不要直接给Toolbar设置纯色背景，将折叠态需要显示的白色背景配置到CollapsingToolbarLayout的contentScrim属性上：折叠状态下组件会自动渲染该不透明背景阻挡穿透内容，展开状态下背景自动透明，不影响展开态头部效果。
  布局配置参考：

  <com.google.android.material.appbar.CollapsingToolbarLayout
      android:id="@+id/collapsingToolbar"
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      app:contentScrim="@android:color/white"
      app:scrimAnimationDuration="200"
      app:layout_scrollFlags="scroll|exitUntilCollapsed">
  
      <!-- 展开态头部内容（大图、大标题等）放在该层级，配置视差折叠模式 -->
      <ImageView
          android:layout_width="match_parent"
          android:layout_height="220dp"
          android:scaleType="centerCrop"
          android:src="@drawable/header_bg"
          app:layout_collapseMode="parallax"/>
  
      <androidx.appcompat.widget.Toolbar
          android:id="@+id/toolbar"
          android:layout_width="match_parent"
          android:layout_height="?attr/actionBarSize"
          android:background="@android:color/transparent"
          app:layout_collapseMode="pin">
          <!-- Toolbar内常驻控件（返回按钮、标题等）放在此处 -->
      </androidx.appcompat.widget.Toolbar>
  </com.google.android.material.appbar.CollapsingToolbarLayout>
  

• 修正SearchView的布局位置与层级配置
  如果需要SearchView在折叠、展开状态都固定在Toolbar区域显示，直接将SearchView作为Toolbar的直接子View放入即可；如果需要SearchView在展开时位于头部区域、折叠时收缩固定到Toolbar，将SearchView放在CollapsingToolbarLayout内、与Toolbar平级的位置，同时给SearchView配置固定折叠模式与z轴高度，避免被scrim层遮挡：

  <androidx.appcompat.widget.SearchView
      android:id="@+id/mainSearchView"
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:layout_gravity="bottom"
      android:layout_marginHorizontal="16dp"
      android:layout_marginBottom="8dp"
      android:elevation="6dp"
      app:layout_collapseMode="pin"
      app:layout_collapseParallaxMultiplier="0.6"/>
  

• 核对主题配置，关闭系统默认ActionBar
  检查styles.xml中的主题配置，必须使用NoActionBar系列主题，避免系统自带ActionBar层级干扰自定义控件显示：

  <style name="AppTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar">
      <item name="windowActionBar">false</item>
      <item name="windowNoTitle">true</item>
      <!-- 其余原有主题属性保留即可 -->
  </style>
  

• 核对NestedScrollView联动属性
  确保NestedScrollView配置了官方标准的AppBar联动行为，避免滚动层级计算异常：

  <androidx.core.widget.NestedScrollView
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      app:layout_behavior="@string/appbar_scrolling_view_behavior">
      <!-- 列表/滚动内容放在此处 -->
  </androidx.core.widget.NestedScrollView>
  

配置完成后验证两个核心场景：

1. 上下滚动NestedScrollView过程中，折叠态下CollapsingToolbarLayout自动渲染白色背景，无列表内容穿透到Toolbar区域的问题
2. 折叠状态下SearchView正常显示在白色背景上方，点击、输入、展开联想菜单功能均正常，无被遮挡情况

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