Android 10及以上应用崩溃重启后状态栏变白如何解决？

问题概述 #

仅在Android 10及以上版本中，应用正常运行时状态栏显示正常，但崩溃重启后状态栏颜色变为白色。

正常状态：
崩溃后状态：

问题根源 #

崩溃后系统恢复Activity时，原有的状态栏配置逻辑未被重新执行，或者Android 10+新增的WindowInsets/对比度机制在恢复过程中使用了默认值，覆盖了自定义配置。

修复方案 #

1. 在onResume中强制重设状态栏 #

每次页面恢复可见时，强制重新设置状态栏颜色及文字样式，确保崩溃恢复后配置生效：

override fun onResume() {
    super.onResume()
    // 设置目标状态栏颜色
    window.statusBarColor = ContextCompat.getColor(this, R.color.your_target_status_bar_color)
    
    // 适配Android 10+的状态栏文字对比度（按需调整）
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        window.isStatusBarContrastEnforced = false // 关闭系统强制对比度，避免颜色被覆盖
    }
    
    // 设置状态栏文字颜色（例如浅色状态栏用深色文字）
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        val decorView = window.decorView
        decorView.systemUiVisibility = decorView.systemUiVisibility or View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR
    }
}

2. 确保onCreate中始终初始化状态栏 #

不管Activity是首次创建还是崩溃恢复，都在onCreate中执行状态栏初始化逻辑：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    // 初始化状态栏配置
    setupStatusBar()
}

private fun setupStatusBar() {
    val window = window
    // 设置状态栏颜色
    window.statusBarColor = ContextCompat.getColor(this, R.color.your_target_status_bar_color)
    
    // 配置状态栏文字样式
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        window.decorView.systemUiVisibility = window.decorView.systemUiVisibility or View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR
    }
    
    // Android 10+ 关闭强制对比度
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        window.isStatusBarContrastEnforced = false
    }
}

3. 检查主题配置是否正确 #

确认App主题中状态栏颜色配置未被系统默认值覆盖，在res/values/styles.xml和res/values-v29/styles.xml中添加：

<style name="AppTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar">
    <!-- 自定义状态栏颜色 -->
    <item name="android:statusBarColor">@color/your_target_status_bar_color</item>
    <!-- Android 10+ 禁用强制对比度 -->
    <item name="android:enforceStatusBarContrast">false</item>
</style>

验证步骤 #

1. 手动触发应用崩溃（比如在代码中添加throw RuntimeException()）
2. 重启应用后查看状态栏颜色是否恢复正常
3. 多次测试崩溃场景，确认问题不再复现

内容的提问来源于stack exchange，提问作者Nguyễn Hữu Thuận