Android Material Toolbar遮挡ViewFlipper问题（API29+复现）求解

核心原因 #

API29及以上系统对WindowInsets的处理逻辑发生变更，同时你的布局缺少CoordinatorLayout配套的滚动行为配置，导致内容被Toolbar遮挡；之前添加fitsSystemWindows后内容过度下移是因为属性配置位置错误，重复计算了系统边距。

可落地解决方案 #

1. 给CoordinatorLayout直接子滚动容器加官方滚动Behavior
   你当前ViewPager外层的ViewFlipper是CoordinatorLayout的直接子View，需要给它添加app:layout_behavior="@string/appbar_scrolling_view_behavior"属性，不要把Behavior加给内层的ViewPager，只有CoordinatorLayout的直接子View配置Behavior才会生效。修改后的ViewFlipper代码如下：

<ViewFlipper
    android:id="@+id/story_viewflipper"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:layout_behavior="@string/appbar_scrolling_view_behavior">

2. 修正fitsSystemWindows配置避免内容过度偏移
   仅保留根CoordinatorLayout和AppBarLayout的android:fitsSystemWindows="true"属性，不要给滚动容器（ViewFlipper）或Toolbar单独加该属性，API29以上系统会自动合并Insets计算，重复添加会导致边距叠加出现内容过度下移的问题。
3. 修复Toolbar复用的兼容问题
   你将Toolbar抽为独立布局，要确认所有引入该Toolbar的页面，父布局都使用CoordinatorLayout+AppBarLayout的结构，并且对应的滚动容器都配置了正确的behavior，不要在Toolbar本身的布局文件中添加fitsSystemWindows、scrollFlags这类依赖父布局的属性，避免多页面引入时出现属性冲突。

排查方向 #

• 检查Activity主题是否配置了android:windowDrawsSystemBarBackgrounds=true，如果使用了透明状态栏配置，确认没有在Activity的window层面额外设置fitsSystemWindows属性
• 升级MaterialComponents依赖版本到1.4.0及以上，旧版本的Material组件存在API29+Insets处理的已知兼容bug
• 若上述配置都生效后仍有兼容问题，可以手动监听WindowInsets动态设置边距兜底：

// 仅在API29以上执行该逻辑
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.story_viewflipper)) { view, insets ->
        val systemBarInsets = insets.getInsets(WindowInsetsCompat.Type.systemBars())
        // 只设置顶部边距，保留原有其他边距配置
        view.setPadding(view.paddingLeft, systemBarInsets.top, view.paddingRight, view.paddingBottom)
        WindowInsetsCompat.CONSUMED
    }
}

相关示意图 #

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