Flutter iOS应用TestFlight安装后偶现启动页卡住问题求助

核心问题分析 #

你的代码中FlutterNativeSplash.remove()依赖固定1ms延迟来触发，这种方式在Release环境（如TestFlight）下存在明显风险：设备性能波动、后台进程干扰、初始化任务（Firebase、Hive、SharedPreferences）的耗时差异，都可能导致延迟结束时Flutter界面尚未完成渲染，进而卡住启动页。另外，MaterialApp的home中通过FutureBuilder重复初始化SharedPreferences，也会增加启动阶段的耗时波动。

具体修复方案 #

1. 调整启动页移除时机 #

移除固定延迟，改用Flutter框架的首帧渲染完成信号来触发启动页移除，确保界面完全就绪后再切换：

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );
  await FirebaseApi().initNotifications();
  HttpOverrides.global = MyHttpOverrides();
  await Hive.initFlutter();
  FirebaseAnalytics analytics = FirebaseAnalytics.instance;
  // 提前获取SharedPreferences，避免后续重复初始化
  final SharedPreferences sharedPreferences = await SharedPreferences.getInstance();

  // 监听首帧渲染完成后移除启动页
  WidgetsBinding.instance.addPostFrameCallback((_) {
    FlutterNativeSplash.remove();
  });

  runApp(AulingerMain(sharedPreferences: sharedPreferences));
}

2. 优化SharedPreferences初始化逻辑 #

将main中已获取的SharedPreferences传递给AulingerMain，避免在checkFirstTime()中重复初始化，同时提前初始化Future防止build时重复执行：

class AulingerMain extends StatefulWidget {
  final SharedPreferences sharedPreferences;
  
  const AulingerMain({super.key, required this.sharedPreferences});

  @override
  State<AulingerMain> createState() => _AulingerMainState();
}

class _AulingerMainState extends State<AulingerMain> {
  late Future<bool> _firstTimeFuture;

  @override
  void initState() {
    super.initState();
    // 提前初始化Future，避免每次build重新创建
    _firstTimeFuture = checkFirstTime();
  }

  Future<bool> checkFirstTime() async {
    return widget.sharedPreferences.getBool('isFirstTime') ?? true;
  }

  @override
  Widget build(BuildContext context) {
    return OverlaySupport(
      child: MultiProvider(
        providers: [
          ListenableProvider<UserProvider>(create: (_) => UserProvider()),
        ],
        child: ThemeModeHandler(
            manager: ThemeManager(),
            builder: (ThemeMode themeMode) {
              return MaterialApp(
                  title: 'Gasthof zum Sonnenwald',
                  debugShowCheckedModeBanner: false,
                  theme: ThemeData(
                      appBarTheme: const AppBarTheme(
                    centerTitle: true,
                    backgroundColor: Colors.amber,
                  )),
                  darkTheme: ThemeData.dark(),
                  themeMode: themeMode,
                  home: FutureBuilder<bool>(
                    future: _firstTimeFuture,
                    builder: (context, snapshot) {
                      if (snapshot.connectionState == ConnectionState.waiting) {
                        return const Center(
                          child: CircularProgressIndicator(color: Colors.amber),
                        );
                      }

                      final isFirstTime = snapshot.data ?? true;
                      return isFirstTime
                          ? const EinfuehrungFrage()
                          : const AutoLoginHandler();
                    },
                  ),
                  builder: (context, child) {
                    return MediaQuery(
                      data: MediaQuery.of(context).copyWith(textScaleFactor: 1.0),
                      child: child!,
                    );
                  },
                  routes: {
                    Settings.routeName: (ctx) => const Settings(),
                    MainPage.routeName: (ctx) => const MainPage(),
                    Speisekarte.routeName: (ctx) => const Speisekarte(),
                    ContactUsPage.routeName: (ctx) => const ContactUsPage(),
                    LoginScreen.routeName: (ctx) => const LoginScreen(),
                    ImprintScreen.routeName: (ctx) => const ImprintScreen(),
                    SelectionScreenEssen.routeName: (ctx) => const SelectionScreenEssen(),
                    PrivacyPolicyScreen.routeName: (ctx) => const PrivacyPolicyScreen(),
                  });
            }),
      ),
    );
  }
}

3. 额外优化建议 #

• 检查FirebaseApi().initNotifications()是否包含非核心耗时操作，可将这类逻辑延迟到首页加载完成后执行，减少启动阶段阻塞
• 确保已重新执行flutter pub run flutter_native_splash:create，避免iOS启动页资源未正确打包到TestFlight版本中
• 在Release版本中添加关键初始化步骤的耗时日志（如通过Firebase Analytics记录），方便后续排查偶发卡顿的具体诱因

内容的提问来源于stack exchange，提问作者Lucas Knötig