Android API 30+状态栏覆盖Toolbar且控件消失问题求助

核心问题原因 #

API 30+ 对系统窗口Insets（状态栏、导航栏）的适配逻辑做了调整：仅给Toolbar设置fitsSystemWindows="true"无法正确传递Insets信息；而使用FLAG_LAYOUT_NO_LIMITS会强制窗口延伸到系统栏下方，导致内容被半透明栏覆盖。

分步解决方案 #

1. 移除全屏Flag #

先删除之前添加的全屏强制代码：

getWindow().setFlags(WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS, WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS);

2. 调整顶层布局的Insets适配 #

给最外层的DrawerLayout添加android:fitsSystemWindows="true"，让它作为Insets的接收容器，自动将系统栏的空间计算传递给子View：

<androidx.drawerlayout.widget.DrawerLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/drawerLayout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="true">

3. 优化Toolbar的高度设置 #

避免固定Toolbar高度，改用系统默认的ActionBar高度作为最小高度，确保适配不同设备的状态栏：

<androidx.appcompat.widget.Toolbar xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/toolbar"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:minHeight="?attr/actionBarSize"
    android:contentInsetEnd="0dp"
    android:contentInsetLeft="0dp"
    android:contentInsetRight="0dp"
    android:contentInsetStart="0dp"
    android:contentInsetStartWithNavigation="0dp"
    android:fitsSystemWindows="true"
    android:theme="@style/ToolbarStyle"
    android:layout_marginBottom="@dimen/box_margin_bottom_small"
    app:contentInsetEnd="0dp"
    app:contentInsetLeft="0dp"
    app:contentInsetRight="0dp"
    app:contentInsetStart="0dp"
    app:contentInsetStartWithNavigation="0dp"
    app:popupTheme="@style/AppTheme.PopupOverlay">

4. 完善主题配置 #

在AppTheme中添加系统栏相关配置，确保状态栏和导航栏正常显示且不覆盖内容：

<style name="AppTheme" parent="Theme.AppCompat.NoActionBar">
    <!-- 状态栏颜色 -->
    <item name="colorPrimaryDark">@color/your_status_bar_color</item>
    <!-- API 21+ 状态栏文字颜色（false为深色文字，true为浅色） -->
    <item name="android:windowLightStatusBar">false</item>
    <!-- 允许窗口绘制系统栏背景 -->
    <item name="android:windowDrawsSystemBarBackgrounds">true</item>
    <!-- 状态栏背景色 -->
    <item name="android:statusBarColor">@color/your_status_bar_color</item>
</style>

5. 代码层面Insets控制（可选） #

如果xml配置后仍有问题，可在Activity中通过WindowInsetsController手动控制系统栏显隐，同时确保内容避开系统栏：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    
    // 清除可能存在的全屏Flag
    getWindow().clearFlags(WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS);
    
    // 配置系统栏行为
    Window window = getWindow();
    WindowInsetsController insetsController = window.getInsetsController();
    if (insetsController != null) {
        // 设置为触摸显示系统栏
        insetsController.setSystemBarsBehavior(WindowInsetsController.BEHAVIOR_SHOW_BARS_BY_TOUCH);
        // 显示状态栏和导航栏
        insetsController.show(WindowInsets.Type.statusBars() | WindowInsets.Type.navigationBars());
    }
    
    // 绑定Toolbar
    Toolbar toolbar = findViewById(R.id.toolbar);
    setSupportActionBar(toolbar);
}

效果验证 #

完成以上配置后，API 30+设备上的Toolbar会自动避开状态栏，底部导航栏也不会覆盖内容，同时支持正常显隐操作。

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