Flutter(GetX)应用真机Release模式反复启动白屏问题求助

我正在开发一款采用GetX状态管理的Flutter应用，在模拟器的Debug和Release模式下运行均正常，但在真机Release模式下，应用会卡在白屏界面；有时首次启动正常，但杀死进程后再次打开仍会出现白屏。

相关代码 #

main.dart #

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:google_fonts/google_fonts.dart';
import 'package:orbit_money_app/controllers/send_money_controller.dart';
import 'package:orbit_money_app/providers/customer_provider.dart';
import 'package:orbit_money_app/routes/route_bindings.dart';
import 'package:get/get.dart';
import 'package:orbit_money_app/util/color_util.dart';
import 'package:provider/provider.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  SystemChrome.setSystemUIOverlayStyle(
    const SystemUiOverlayStyle(
      statusBarColor: Colors.white,
      statusBarIconBrightness: Brightness.dark,
      systemNavigationBarColor: Colors.transparent,
      systemNavigationBarIconBrightness: Brightness.dark,
    ),
  );

  SystemChrome.setPreferredOrientations([DeviceOrientation.portraitUp]);
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});
  @override
  Widget build(BuildContext context) {
    return MultiProvider(
      providers: [
        ChangeNotifierProvider(create: (context) => CustomerProvider()),
      ],
      child: GetMaterialApp(
        debugShowCheckedModeBanner: false,
        title: 'Orbit Money',
        theme: ThemeData(
            colorScheme: ColorScheme.fromSeed(
              seedColor: ColorUtil.secondaryColor,
              secondary: ColorUtil.secondaryColor,
              primary: ColorUtil.secondaryColor,
            ),
            primarySwatch: Colors.red,
            useMaterial3: true,
            inputDecorationTheme: InputDecorationTheme(
                focusedBorder: const OutlineInputBorder(
                  borderSide: BorderSide(
                    color: ColorUtil.secondaryColor,
                  ),
                  borderRadius: BorderRadius.all(Radius.circular(10)),
                ),
                enabledBorder: const OutlineInputBorder(
                  borderSide: BorderSide(
                    color: ColorUtil.secondaryColor,
                  ),
                  borderRadius: BorderRadius.all(Radius.circular(10)),
                ),
                border: const OutlineInputBorder(
                  borderSide: BorderSide(
                    color: ColorUtil.secondaryColor,
                  ),
                  borderRadius: BorderRadius.all(Radius.circular(10)),
                ),
                errorBorder: const OutlineInputBorder(
                  borderSide: BorderSide(
                    color: Colors.red,
                  ),
                  borderRadius: BorderRadius.all(Radius.circular(10)),
                ),
                errorStyle: GoogleFonts.poppins(
                  color: Colors.red,
                ))),
        getPages: RouteBindings.routes,
        initialRoute: RouteBindings.getInitialRoute(),
        initialBinding: BindingsBuilder(() {
          Get.lazyPut(() => SendMoneyController());
        }),
      ),
    );
  }
}

GetStarted2View页面代码 #

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:get/get.dart';
import 'package:google_fonts/google_fonts.dart';
import 'package:orbit_money_app/util/color_util.dart';
import 'package:orbit_money_app/routes/route_names.dart';

class GetStarted2View extends GetWidget {
  const GetStarted2View({super.key});

  @override
  Widget build(BuildContext context) {
    SystemChrome.setSystemUIOverlayStyle(
      const SystemUiOverlayStyle(
        statusBarColor: Colors.transparent,
        statusBarIconBrightness: Brightness.dark,
        systemNavigationBarColor: Colors.transparent,
        systemNavigationBarIconBrightness: Brightness.light,
      ),
    );
    return Scaffold(
        body: Container(
      padding: EdgeInsets.symmetric(
          horizontal: Get.mediaQuery.size.width * 0.05,
          vertical: Get.mediaQuery.size.height * 0.1),
      decoration: const BoxDecoration(
        image: DecorationImage(
          image: AssetImage(
              'lib/assets/background_images/offwhite_circles_background.png'),
          fit: BoxFit.cover,
        ),
      ),
      height: Get.mediaQuery.size.height,
      width: Get.mediaQuery.size.width,
      child: Column(
        mainAxisAlignment: MainAxisAlignment.spaceBetween,
        crossAxisAlignment: CrossAxisAlignment.center,
        children: [
          Image.asset(
            'lib/assets/logos/logo_long_black.png',
            width: Get.mediaQuery.size.width * 0.5,
          ),
          Column(
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
              Text(
                "Hello!",
                style: GoogleFonts.poppins(
                    fontSize: Get.mediaQuery.size.width * 0.1,
                    fontWeight: FontWeight.w600,
                    color: ColorUtil.secondaryColor),
              ),
              const SizedBox(
                height: 10,
              ),
              Text(
                "Welcome to Orbitmoney app, seamless experiences await at your fingertips!",
                style: GoogleFonts.poppins(
                    fontSize: Get.mediaQuery.size.width * 0.045,
                    fontWeight: FontWeight.w400,
                    color: ColorUtil.secondaryColor),
              ),
              const SizedBox(
                height: 25,
              ),
              Row(
                children: [
                  InkWell(
                    onTap: () {
                      Get.toNamed(RouteNames.signIn);
                    },
                    child: Container(
                      padding: EdgeInsets.symmetric(
                          horizontal: Get.mediaQuery.size.width * 0.05,
                          vertical: Get.mediaQuery.size.width * 0.035),
                      decoration: BoxDecoration(
                        border: Border.all(
                          color: ColorUtil.tertiaryColor,
                          width: 1,
                        ),
                        borderRadius: BorderRadius.circular(15),
                      ),
                      child: Text(
                        "Sign In",
                        style: GoogleFonts.poppins(
                            fontSize: Get.mediaQuery.size.width * 0.05,
                            fontWeight: FontWeight.w500,
                            color: Colors.black),
                      ),
                    ),
                  ),
                  SizedBox(
                    width: Get.mediaQuery.size.width * 0.03,
                  ),
                  ElevatedButton(
                    onPressed: () {
                      Get.toNamed(RouteNames.chooseAgent);
                    },
                    style: ElevatedButton.styleFrom(
                      padding: EdgeInsets.symmetric(
                          horizontal: Get.mediaQuery.size.width * 0.15,
                          vertical: Get.mediaQuery.size.width * 0.035),
                      backgroundColor: ColorUtil.tertiaryColor,
                      shape: RoundedRectangleBorder(
                        borderRadius: BorderRadius.circular(15),
                      ),
                    ),
                    child: Text(
                      "Get Started",
                      style: GoogleFonts.poppins(
                          fontSize: Get.mediaQuery.size.width * 0.05,
                          fontWeight: FontWeight.w400,
                          color: Colors.white),
                    ),
                  )
                ],
              ),
            ],
          ),
        ],
      ),
    ));
  }
}

错误截图 #

排查与解决建议 #

1. 检查资源文件路径与打包配置 #

Release模式下资源加载失败是白屏常见原因：

• 确认pubspec.yaml中已正确声明assets路径，示例：

  assets:
    - assets/background_images/
    - assets/logos/
  

• 简化AssetImage路径为相对路径，比如将lib/assets/xxx改为assets/xxx，对应pubspec中的配置。

2. 调整GetX初始化逻辑 #

• 检查RouteBindings.getInitialRoute()的逻辑，确认Release模式下返回的路由无异步阻塞或未处理异常。
• 将initialBinding中的延迟加载改为立即加载，排查是否是延迟初始化导致的阻塞：

  initialBinding: BindingsBuilder(() {
    Get.put(SendMoneyController());
  }),
  

3. 添加全局异常捕获 #

在main函数中加入全局异常捕获，定位具体崩溃点：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 原有系统配置代码...
  FlutterError.onError = (details) {
    FlutterError.presentError(details);
  };
  runZonedGuarded(() {
    runApp(const MyApp());
  }, (error, stackTrace) {
    print('全局未处理异常：$error');
    print(stackTrace);
  });
}

4. 排查状态管理冲突 #

项目同时使用Provider和GetX，可能存在初始化冲突：

• 暂时移除MultiProvider，仅保留GetX运行，验证是否是Provider导致的阻塞。
• 检查CustomerProvider的初始化逻辑，确保无耗时操作或未处理异常。

5. 真机Release模式调试 #

• Android：使用adb logcat命令过滤Flutter相关日志，查看具体错误信息。
• iOS：在Xcode中选择Release模式连接真机运行，查看控制台输出。

内容的提问来源于stack exchange，提问作者Zaid Ahmed Soomro