Flutter发布版APK重启后UI消失问题求助

问题概述 #

Release版APK安装后首次打开运行正常，但关闭后再次启动时UI元素消失；重启设备后首次打开应用正常，关闭后再次打开复现问题。Debug版本无异常，使用GetX框架，同类架构应用未出现该问题。已尝试移除Scaffold外层容器、简化UI、更新Kotlin等操作，flutter run --release无日志输出，Flutter检测正常。

可能的解决方向 #

1. 规范GetX控制器生命周期 #

Release模式下GetX的缓存机制可能导致二次启动时控制器未正确初始化或状态残留：

• 确保tabController在控制器的onInit中初始化，onClose中销毁：

  @override
  void onInit() {
    super.onInit();
    tabController = TabController(length: 2, vsync: this);
  }
  
  @override
  void onClose() {
    tabController.dispose();
    super.onClose();
  }
  

• 若使用全局单例控制器，在应用启动时调用Get.reset()重置状态：

  void main() {
    WidgetsFlutterBinding.ensureInitialized();
    Get.reset();
    runApp(MyApp());
  }
  

2. 排查资源加载异常 #

Release模式下资源压缩或缓存可能导致二次加载失败：

• 检查pubspec.yaml中资源配置路径是否准确，确保打包时资源被正确包含：

  assets:
    - assets/background_image.png
    - assets/logo_image.png
  

• 尝试给Image.asset指定缓存参数，避免缓存异常：

  Image.asset(
    AppConstants.assets.logo_image,
    cacheWidth: (size.width * 0.8).toInt(),
    cacheHeight: (size.height * 0.3).toInt(),
  )
  

3. 修复布局计算逻辑 #

原布局依赖Get.width/Get.height，二次启动时GetX可能未正确初始化全局尺寸：

• 替换为MediaQuery获取尺寸，确保布局计算依赖上下文：

  final size = MediaQuery.of(context).size;
  // 后续用size.width/size.height替代Get.width/Get.height
  

• 优化布局结构，移除SingleChildScrollView+Column(min: true)的组合，改用Expanded分配空间：

  body: Column(
    children: [
      Expanded(
        flex: 45,
        child: Center(
          child: Padding(
            padding: const EdgeInsets.only(top: 80.0),
            child: SizedBox(
              width: size.width * 0.8,
              height: size.height * 0.3,
              child: Image.asset(AppConstants.assets.logo_image),
            ),
          ),
        ),
      ),
      Expanded(
        flex: 55,
        child: TabBarView(
          controller: controller.tabController,
          physics: NeverScrollableScrollPhysics(),
          children: [TelephoneTab(), CodeTab()],
        ),
      ),
    ],
  )
  

4. 关闭Release模式优化排查 #

临时关闭混淆和资源压缩，确认是否为优化导致的问题：

• 修改android/app/build.gradle：

  buildTypes {
      release {
          minifyEnabled false
          shrinkResources false
          signingConfig signingConfigs.release
      }
  }
  

• 若问题消失，添加Flutter和GetX的混淆白名单到android/app/proguard-rules.pro：

  -keep class io.flutter.** { *; }
  -keep class com.getx.** { *; }
  -keep class your.package.name.** { *; } // 替换为你的应用包名
  

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