Flutter应用启动过慢求助：main函数初始化优化建议

你的核心问题是main函数中同步阻塞的初始化任务过多，导致App无法快速渲染闪屏页，用户看到黑屏或长时间等待。以下是针对性的优化建议：

1. 优先渲染闪屏页，将初始化移至闪屏页异步执行 #

现在的代码是等待所有初始化完成后才调用runApp，直接导致启动阶段UI完全阻塞。正确的做法是先启动极简的闪屏页，然后在闪屏页的initState中异步执行所有初始化任务，完成后再跳转至主页面。

修改后的main函数示例： #

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 只保留启动前必须的、轻量的操作
  lockOrientation();
  SystemChrome.setSystemUIOverlayStyle(
    const SystemUiOverlayStyle(
      statusBarBrightness: Brightness.dark,
      systemNavigationBarColor: AppColors.transparent,
    ),
  );
  // FlutterSecureStorage实例创建是同步操作，无需await
  storage = const FlutterSecureStorage(
    iOptions: IOSOptions(accessibility: KeychainAccessibility.first_unlock),
    aOptions: AndroidOptions(encryptedSharedPreferences: true),
  );

  // 直接启动闪屏页，不等待任何初始化完成
  runZonedGuarded(
    () => ProviderScope(child: runApp(const SplashScreen())),
    FirebaseCrashlytics.instance.recordError,
  );
}

闪屏页核心逻辑示例： #

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

  @override
  State<SplashScreen> createState() => _SplashScreenState();
}

class _SplashScreenState extends State<SplashScreen> {
  @override
  void initState() {
    super.initState();
    _runInitializationTasks();
  }

  Future<void> _runInitializationTasks() async {
    try {
      // 并行执行多个初始化任务，减少总耗时
      await Future.wait([
        Firebase.initializeApp(),
        setupInjector(),
        setupLocator(),
        Hive.initFlutter(),
      ]);

      // 执行Hive相关的模型/服务初始化
      await initModels();
      final services = await initDbServices();
      final downloadServices = await initDownloadDbServices();

      // 配置Crashlytics
      await FirebaseCrashlytics.instance.setCrashlyticsCollectionEnabled(!kDebugMode);
      FlutterError.onError = FirebaseCrashlytics.instance.recordFlutterError;
      Isolate.current.addErrorListener(RawReceivePort((pair) async {
        final List<dynamic> errorAndStacktrace = pair;
        await FirebaseCrashlytics.instance.recordError(
          errorAndStacktrace.first,
          errorAndStacktrace.last,
        );
      }).sendPort);

      // 内购注册：可延迟至用户进入购买页面时再执行，减少启动负载
      if (Platform.isIOS) {
        InAppPurchaseStoreKitPlatform.registerPlatform();
      } else if (!DeviceInfo.isHarmonyOS) {
        InAppPurchaseAndroidPlatform.registerPlatform();
      }

      // RemoteConfig配置：后台异步执行，无需等待完成再跳转
      unawaited(_setupRemoteConfig());

      // 监听推送通知
      NotificationService.instance.listenPushNotifications?.listen((uri) => deeplinkUri = uri);

      // 初始化完成后跳转主页面
      if (mounted) {
        Navigator.of(context).pushReplacement(MaterialPageRoute(builder: (_) => MyApp()));
      }
    } catch (e) {
      FirebaseCrashlytics.instance.recordError(e, StackTrace.current);
      // 可选：跳转错误页面或重试初始化
    }
  }

  Future<void> _setupRemoteConfig() async {
    RemoteConfigSettings setting = RemoteConfigSettings(
      minimumFetchInterval: const Duration(hours: 1),
      fetchTimeout: const Duration(minutes: 1),
    );
    await remoteConfig.setConfigSettings(setting);
    await remoteConfig.fetchAndActivate();
  }

  @override
  Widget build(BuildContext context) {
    // 这里渲染你的视频闪屏页，确保UI能快速加载
    return const Scaffold(
      body: Center(
        child: // 你的视频播放器或闪屏图片组件
      ),
    );
  }
}

2. 拆分初始化任务，区分「必要」和「非必要」 #

• 必要初始化：仅保留启动闪屏页必须的操作（比如锁方向、SystemUI设置、Storage实例创建），其余全部移至闪屏页异步执行。
• 非必要初始化：
  • 内购注册：可以延迟到用户进入购买页面时再执行，无需在启动阶段完成。
  • RemoteConfig：可以后台异步执行，即使未完成也不影响App启动，后续再用最新配置更新UI。
  • 某些Hive服务：如果不是主页面立即需要的，可以延迟到对应的页面加载时再初始化。

3. 优化并行初始化效率 #

使用Future.wait将多个互不依赖的初始化任务并行执行，减少总耗时。比如将Firebase初始化、依赖注入设置、Hive初始化放在同一个Future.wait中，而不是串行等待。

注意：如果某些任务有依赖关系（比如必须先初始化Hive才能初始化Hive服务），则需要保持串行顺序，但尽量减少串行链的长度。

4. 针对性优化第三方库初始化 #

• Firebase：如果使用的是Firebase模块化SDK，只初始化你实际用到的模块（比如Auth、Crashlytics），而不是初始化整个FirebaseApp，减少不必要的加载。
• Hive：检查initModels和initDbServices中的操作，是否有大量的模型注册或数据库打开操作。可以考虑分批次初始化：主页面需要的先初始化，其他的后台异步初始化。
• FlutterSecureStorage：实例创建是同步操作，无需await，避免无意义的阻塞。

5. 其他通用启动优化 #

• 减少包体积：启用R8/ProGuard（Android）和Bitcode（iOS）混淆，拆分ABI（Android），减少App启动时的加载压力。
• 监控性能瓶颈：使用Flutter DevTools的Performance面板，或Android Studio Profiler、iOS Instruments分析启动过程中的耗时任务，定位重点优化对象。
• 避免在启动阶段执行IO操作：所有涉及文件读写、网络请求的操作都要异步执行，且尽量放在闪屏页或后台。

内容的提问来源于stack exchange，提问作者Kaan Taha Köken