You need to enable JavaScript to run this app. Flutter 1.22.4升级Android V2嵌入后Release模式启动页崩溃求助
优惠活动
大模型
产品
解决方案
定价
更多

Flutter 1.22.4升级Android V2嵌入后Release模式启动页崩溃求助

崩溃根因

升级V2嵌入架构后,Release构建下出现该崩溃的核心触发逻辑是:应用冷启动阶段,系统会优先唤起独立的后台Service(这里就是FlutterFirebaseMessagingService),此时进程还没走到常规的Activity/Application层Flutter初始化流程,Service的onCreate方法直接调用Flutter初始化校验接口,因为前置的startInitialization流程没有执行,直接触发状态校验异常。
Debug构建下不会复现该问题,是因为Debug模式下Flutter初始化时序更宽松,且后台Service不会在冷启动最早期被系统优先调度。

具体修复方案
  • 重构Flutter初始化时序,将初始化逻辑从Activity层上移到Application层,匹配Flutter 1.22.4的V2嵌入要求:
    • 在自定义Application的attachBaseContext方法中提前触发Flutter初始化,覆盖Service先于Application核心逻辑执行的时序差:
      import io.flutter.embedding.engine.loader.FlutterLoader;
      
      @Override
      protected void attachBaseContext(Context base) {
          super.attachBaseContext(base);
          // 提前启动Flutter初始化
          FlutterLoader.getInstance().startInitialization(base);
      }
      
    • 在Application的onCreate方法中补全初始化完成的状态通知,打通初始化校验闭环:
      @Override
      public void onCreate() {
          super.onCreate();
          // 标记Flutter初始化完成
          FlutterLoader.getInstance().ensureInitializationComplete(this, null);
      }
      
  • 调整Manifest中Firebase消息服务的配置,避免冷启动阶段被系统过早唤起:
    在AndroidManifest.xml中覆写插件自动注册的FlutterFirebaseMessagingService配置,新增进程绑定属性,切断系统在应用未完全启动时唤起服务的路径:
    <service
        android:name="io.flutter.plugins.firebasemessaging.FlutterFirebaseMessagingService"
        android:stopWithTask="true"
        android:exported="false">
        <intent-filter>
            <action android:name="com.google.firebase.MESSAGING_EVENT" />
        </intent-filter>
    </service>
    
  • 补全Release构建的混淆保留规则:
    因为Release构建会开启R8/Proguard裁剪,容易误删Flutter初始化相关的类导致状态异常,需要在proguard-rules.pro中增加保留规则:
    -keep class io.flutter.embedding.engine.loader.** { *; }
    -keep class io.flutter.plugins.firebasemessaging.** { *; }
    

注意:不要强行升级高于1.22.4兼容范围的firebase_messaging插件版本,否则会引入新的V2嵌入兼容问题,上述方案完全适配你当前使用的Flutter 1.22.4版本。

内容的提问来源于stack exchange,提问作者user4246398

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 06:06:01