升级Java 17后Flutter应用在Android重启时白屏问题排查求助

核心原因推测 #

这个问题大概率是Java 17 与 Android 12 的兼容性 + Flutter 3.0.0 对高版本Android/Java的适配不足共同导致的——Android 12引入了android:exported属性强制要求、ART虚拟机对Java 17字节码的处理差异，或是Flutter引擎在重启时的资源加载逻辑冲突，都可能引发重启后UI渲染失败的问题。

分步解决方法 #

1. 修复AndroidManifest.xml的android:exported属性 #

Android 12强制要求所有四大组件（Activity、Service等）声明android:exported属性，Flutter 3.0.0的默认模板可能未自动适配：

• 打开android/app/src/main/AndroidManifest.xml
• 为主Activity（通常是io.flutter.embedding.android.FlutterActivity）添加android:exported="true"，其他自定义组件根据是否对外暴露设置该属性：

<activity
    android:name=".MainActivity"
    android:exported="true"
    android:launchMode="singleTop"
    android:theme="@style/LaunchTheme"
    android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
    android:hardwareAccelerated="true"
    android:windowSoftInputMode="adjustResize">

2. 调整Gradle配置，兼容Java 17与Android 12 #

Flutter 3.0.0默认的Gradle配置对Java 17支持不足，需手动修改：

• 打开android/build.gradle，更新Gradle插件和Kotlin版本：

buildscript {
    ext.kotlin_version = '1.6.10'
    repositories {
        google()
        mavenCentral()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:7.0.4'
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

• 打开android/app/build.gradle，指定Java编译版本为17：

android {
    compileSdkVersion 31

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
        targetCompatibility JavaVersion.VERSION_17
    }

    kotlinOptions {
        jvmTarget = '17'
    }
}

3. 禁用Flutter启动缓存（针对重启白屏） #

Android 12的应用重启逻辑可能与Flutter缓存机制冲突，尝试禁用启动缓存：

• 若为Java/Kotlin工程，在MainActivity的onCreate方法中添加：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    FlutterMain.startInitialization(this);
    FlutterMain.ensureInitializationComplete(this, null);
}

• 若为纯Flutter工程，在main.dart中延迟初始化避免资源竞争：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Future.delayed(const Duration(milliseconds: 100));
  runApp(const MyApp());
}

4. 升级Flutter版本（可选但推荐） #

Flutter 3.0.0是较旧版本，后续3.3+版本针对Android 12和Java 17做了大量适配，若上述方法无效，建议升级：

flutter upgrade

验证步骤 #

1. 执行flutter clean
2. 删除模拟器中的应用后重新安装
3. 启动应用正常操作后重启，检查白屏问题是否解决

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