Flutter中多次调用runApp()时如何保留初始路由？

核心原因 #

两次调用runApp()会完全替换整个Widget树，第一次runApp()创建的路由上下文会被销毁，因此通过ModalRoute保存的上下文会失效，导致初始路由信息丢失。

推荐解决方案：单一根Widget管理状态切换 #

避免多次调用runApp()，改用一个根Widget处理异步初始化逻辑，根据初始化状态切换显示启动页或主应用，这样路由上下文不会被销毁，同时能正确保留初始路由（包括Deep Link场景）。

示例代码：

import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:go_router/go_router.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(const RootApp());
}

class RootApp extends StatefulWidget {
  const RootApp({super.key});

  @override
  State<RootApp> createState() => _RootAppState();
}

class _RootAppState extends State<RootApp> {
  bool _isInitialized = false;
  String? _initialRoute;

  @override
  void initState() {
    super.initState();
    _initApp();
  }

  Future<void> _initApp() async {
    // 从系统层面获取初始路由（支持Deep Link）
    _initialRoute = WidgetsBinding.instance.window.defaultRouteName;
    await configuration(); // 你的异步初始化逻辑
    if (mounted) {
      setState(() {
        _isInitialized = true;
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    if (!_isInitialized) {
      return const SplashApp();
    }

    // 使用获取到的初始路由初始化GoRouter
    final goRouter = GoRouter(
      initialLocation: _initialRoute ?? '/',
      routes: <RouteBase>[
        // 你的路由定义示例
        GoRoute(
          path: '/',
          builder: (context, state) => const HomePage(),
        ),
        // 其他路由...
      ],
    );

    return ProviderScope(
      child: MaterialApp.router(
        routerConfig: goRouter,
      ),
    );
  }
}

class SplashApp extends StatelessWidget {
  const SplashApp({super.key});

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(
      home: SplashPage(),
    );
  }
}

// 示例占位Widget
class SplashPage extends StatelessWidget {
  const SplashPage({super.key});

  @override
  Widget build(BuildContext context) {
    return const Scaffold(body: Center(child: Text('Splash')));
  }
}

class HomePage extends StatelessWidget {
  const HomePage({super.key});

  @override
  Widget build(BuildContext context) {
    return const Scaffold(body: Center(child: Text('Home')));
  }
}

Future<void> configuration() async {
  // 模拟异步初始化
  await Future.delayed(const Duration(seconds: 2));
}

备选方案：提前获取初始路由（若必须用两次runApp） #

如果因特殊需求必须调用两次runApp()，可以在第一次调用前直接从Flutter核心绑定获取初始路由，而非依赖Widget上下文：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 提前获取系统传入的初始路由
  final initialRoute = WidgetsBinding.instance.window.defaultRouteName;
  
  runApp(const SplashApp());
  await configuration();
  
  // 初始化GoRouter时传入预获取的初始路由
  final goRouter = GoRouter(
    initialLocation: initialRoute,
    routes: <RouteBase>[
      // 你的路由定义
    ],
  );
  
  runApp(ProviderScope(
    child: MaterialApp.router(routerConfig: goRouter),
  ));
}

关键说明 #

• 不要通过ModalRoute保存路由上下文：第一次runApp()的Widget树被替换后，对应的上下文已被销毁，保存的路由信息会失效。
• 官方不推荐多次调用runApp()：相关讨论指出，多次调用runApp()会导致状态丢失、资源泄漏等问题，建议始终使用单一根Widget管理应用状态切换。

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