Flutter Release Build安装后崩溃（Firebase相关异常）

核心问题 #

这是Java方法缺失异常，崩溃根源是java.util.Date.toInstant()方法找不到。该方法是Java 8新增的API，但在Android API Level < 26的系统中，原生Date类并未实现这个方法，而Firebase的心跳信息存储模块（HeartBeatInfoStorage）调用了此方法，导致应用启动时崩溃。

诱因拆解 #

• 运行设备的Android系统版本低于API 26，原生SDK不支持Date.toInstant()。
• Firebase依赖库默认使用Java 8 API，但项目未配置Java 8兼容支持，或Release构建时R8混淆工具移除了兼容层代码。

解决步骤 #

1. 开启Android项目Java 8支持 #

打开模块级android/app/build.gradle，添加如下配置：

android {
    // 保留原有配置
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

    kotlinOptions {
        jvmTarget = '1.8'
    }
}

2. 更新Firebase依赖版本 #

在pubspec.yaml中确保所有Firebase插件使用最新稳定版，示例：

dependencies:
  firebase_core: ^2.15.0
  firebase_messaging: ^14.6.5
  # 根据你的项目需求添加其他Firebase插件

执行flutter pub get完成依赖更新。

3. 配置R8混淆规则（若启用混淆） #

如果Release构建开启了R8压缩，在android/app/proguard-rules.pro中添加规则避免Firebase相关方法被误删：

-keep class com.google.firebase.heartbeatinfo.** { *; }
-keepclassmembers class java.util.Date {
    public java.time.Instant toInstant();
}

4. 低版本设备验证 #

测试时覆盖Android API 21~25的设备，确认崩溃不再出现。

内容的提问来源于stack exchange，提问作者Java Nerd