Flutter Android应用后台重启卡在启动页的问题求助

核心现象 #

应用切换后台并间隔一段时间后重新打开，卡在启动页无法进入；onCreated()中的#startAppInit日志未输出，说明Flutter侧初始化流程未触发，问题大概率出在Android端引擎恢复或初始化时机上。

可能原因及修复方案 #

1. Flutter绑定初始化时机错误

你的onCreated()中才调用WidgetsFlutterBinding.ensureInitialized()，但main函数先执行await onCreated()——异步操作启动时Flutter核心绑定尚未初始化，会导致引擎启动异常。

修复：将绑定初始化移至main函数最开头，放在任何异步操作之前：

void main() async {
  WidgetsFlutterBinding.ensureInitialized(); // 调整到此处
  await onCreated();
  runApp(const App());
}

2. Activity启动模式与引擎恢复冲突

当前launchMode="singleTop"，应用被系统回收后重新打开时，可能触发onNewIntent但Flutter引擎未正确响应，导致初始化流程中断。

修复：

• 优先尝试修改启动模式为singleTask：

android:launchMode="singleTask"

• 若必须保留singleTop，需重写onNewIntent确保引擎处理新Intent：

class MainActivity: FlutterActivity() {
    override fun onNewIntent(intent: Intent) {
        super.onNewIntent(intent)
        flutterEngine?.navigationChannel?.pushRoute(intent.dataString)
    }
}

3. 旧版启动页配置阻塞

你使用的io.flutter.app.android.SplashScreenUntilFirstFrame是Flutter Embedding v1的配置，在v2环境下可能导致启动页无法自动消失。

修复：

• 删除旧版启动页相关meta-data：

<!-- 删除以下两行 -->
<meta-data
    android:name="io.flutter.app.android.SplashScreenUntilFirstFrame"
    android:value="true" />

<meta-data
    android:name="io.flutter.embedding.android.SplashScreenDrawable"
    android:resource="@drawable/launch_background" />

• 改用v2标准方式，在LaunchTheme中配置启动页背景：

<style name="LaunchTheme" parent="@android:style/Theme.Black.NoTitleBar">
    <item name="android:windowBackground">@drawable/launch_background</item>
</style>

4. 初始化流程中的阻塞操作

onCreated()中的异步任务（如相机检查、应用信息查询）在后台恢复时可能因权限、系统限制等出现无限等待，导致初始化卡死。

修复：

• 为每个异步任务添加超时处理：

Future onCreated() async {
    logInfo("#startAppInit");
    await initMMKV().timeout(const Duration(seconds: 3), onTimeout: () {});
    await _queryAppInfo().timeout(const Duration(seconds: 5), onTimeout: () {});
    await CameraChecker.getInstance().startCheck().timeout(const Duration(seconds: 3), onTimeout: () {});
    await _init().timeout(const Duration(seconds: 5), onTimeout: () {});
    await _initAppEnv().timeout(const Duration(seconds: 5), onTimeout: () {});
}

• 排查依赖前台的操作（如相机检查），添加状态判断：

// CameraChecker中添加权限/前台状态判断
Future startCheck() async {
    if (!await Permission.camera.isGranted || !await AppLifecycleListener.isAppInForeground()) {
        return;
    }
    // 原有检查逻辑
}

5. 引擎重启失败

应用被系统回收后，FlutterActivity可能未正确重新初始化引擎。

修复：重写引擎配置方法，确保初始化完整性：

class MainActivity: FlutterActivity() {
    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        // 此处可注册自定义插件，确保插件重新初始化
    }

    override fun cleanUpFlutterEngine(flutterEngine: FlutterEngine) {
        super.cleanUpFlutterEngine(flutterEngine)
        // 清理插件资源，避免内存泄漏
    }
}

验证步骤 #

修改后，可通过开发者选项开启「不保留活动」模拟系统回收，然后重新打开应用，检查#startAppInit日志是否输出，以及应用是否能正常进入主页面。

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