Android Jetpack Compose 横竖屏切换时出现白屏问题求助

数据老陈

2026-7-4

解决Jetpack Compose横竖屏切换Activity重建与白屏问题

一、排查ViewModel与状态保存的正确性

确保ViewModel通过viewModel()方法获取，而非手动实例化，系统会在配置变化时自动保留ViewModel实例：
```
val viewModel = viewModel<YourViewModel>()
```
检查rememberSaveable的使用：对于需在配置变化后保留的简单状态（字符串、基本类型、Parcelable对象），要正确包裹；复杂对象需自定义Saver：
```
val state = rememberSaveable(saver = YourCustomSaver) { mutableStateOf(YourComplexObject()) }
```

二、处理Activity重建（按需选择）

若业务允许禁止配置变化时重建Activity，可在AndroidManifest.xml中给目标Activity添加配置：

<activity
    android:name=".YourActivity"
    android:configChanges="orientation|screenSize|smallestScreenSize">
</activity>

⚠️ 注意：此时需手动处理UI适配逻辑，比如在Activity的onConfigurationChanged方法中更新Compose布局的适配参数。

三、消除横竖屏切换前的白屏

白屏多因系统配置变化时的窗口过渡问题，可通过以下方式解决：

设置Activity主题背景：在res/values/styles.xml中给Activity主题添加windowBackground，匹配App主色调或启动页背景：

<style name="YourActivityTheme" parent="Theme.Material3.DayNight.NoActionBar">
    <item name="android:windowBackground">@color/your_main_background</item>
</style>

优化UI重组性能：排查Compose布局中频繁重组的节点，用derivedStateOf计算衍生状态，用key限定重组范围，减少不必要的UI重绘：
```
val derivedState = remember { derivedStateOf { /* 仅当依赖变化时计算 */ } }
```
适配图片加载库：若使用第三方图片加载库，配置内存缓存策略，避免配置变化时重新加载资源引发空白。