Flutter升级Gradle8后仅Release模式启动崩溃求助

问题现象 #

Gradle升级至8.0.2版本后，应用仅在Release模式下启动崩溃，Debug模式运行完全正常。崩溃发生在应用启动阶段，错误日志提示类兼容性变更异常。

错误日志 #

E/AndroidRuntime(21410): FATAL EXCEPTION: main
E/AndroidRuntime(21410): Process: com.project.myproject, PID: 21410
E/AndroidRuntime(21410): java.lang.IncompatibleClassChangeError: Class 'android.content.res.XmlBlock$Parser' does not implement interface 'la.a' in call to 'int la.a.next()' (declaration of 'androidx.core.content.f' appears in /data/app/com.pavemotors.paveplus-1V1FH1D8p_zC2xK_nPBRAg==/base.apk)
E/AndroidRuntime(21410):        at androidx.core.content.f.h(Unknown Source:19)
E/AndroidRuntime(21410):        at androidx.core.content.f.e(Unknown Source:11)
E/AndroidRuntime(21410):        at androidx.core.content.f.attachInfo(Unknown Source:31)
E/AndroidRuntime(21410):        at android.app.ActivityThread.installProvider(ActivityThread.java:7273)
E/AndroidRuntime(21410):        at android.app.ActivityThread.installContentProviders(ActivityThread.java:6813)
E/AndroidRuntime(21410):        at android.app.ActivityThread.handleBindApplication(ActivityThread.java:6699)
E/AndroidRuntime(21410):        at android.app.ActivityThread.access$2000(ActivityThread.java:273)
E/AndroidRuntime(21410):        at android.app.ActivityThread$H.handleMessage(ActivityThread.java:2020)
E/AndroidRuntime(21410):        at android.os.Handler.dispatchMessage(Handler.java:112)
E/AndroidRuntime(21410):        at android.os.Looper.loop(Looper.java:216)
E/AndroidRuntime(21410):        at android.app.ActivityThread.main(ActivityThread.java:7625)
E/AndroidRuntime(21410):        at java.lang.reflect.Method.invoke(Native Method)
E/AndroidRuntime(21410):        at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:524)
E/AndroidRuntime(21410):        at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:987)

当前配置 #

pubspec.yaml依赖列表 #

app_tracking_transparency: ^2.0.4
auto_size_text: ^3.0.0
bip32: ^2.0.0
bip39: ^1.0.6
cached_network_image: ^3.3.1
cloud_firestore: 4.15.5
cloud_functions: 4.6.5
collection: ^1.18.0
connectivity_plus: ^5.0.2
cupertino_icons: ^1.0.6
encrypt: ^5.0.1
equatable: ^2.0.5
firebase_auth: 4.17.5
firebase_auth_mocks: ^0.13.0
firebase_core: 2.25.4
firebase_messaging: 14.7.16
firebase_storage: 11.6.6
flutter:
  sdk: flutter
flutter_launcher_icons: ^0.13.1
flutter_reactive_ble: 5.3.1
flutter_riverpod: 2.4.10
flutter_secure_storage: ^9.0.0
flutter_svg: ^2.0.9
fluttertoast: ^8.2.4
font_awesome_flutter: ^10.5.0
gap: ^3.0.1
geolocator: ^11.0.0
get_storage: ^2.1.1
go_router: 13.2.0
google_maps_flutter: 2.5.3
google_sign_in: 6.2.1
http: ^1.2.0
image: ^4.1.6
image_cropper: ^5.0.0
image_picker: ^1.0.7
lints: ^3.0.0
local_auth: ^2.1.8
logger: ^2.0.2+1
permission_handler: 10.4.5
provider: ^6.0.2
qr_flutter: ^4.1.0
quiver: ^3.2.1
riverpod_annotation: 2.3.3
riverpod_lint: 2.3.9
rxdart: ^0.27.7
sign_in_with_apple: ^5.0.0
slide_to_act: ^2.0.2
sqflite: 2.3.2
time: ^2.1.4
url_launcher: ^6.2.3
vibration: ^1.8.4
weather: ^3.1.1
web3dart: 2.7.2

项目根目录build.gradle配置 #

buildscript {
    ext.kotlin_version = '1.8.21'
    repositories {
        google()
        jcenter()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:8.0.2'
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
        classpath 'com.google.gms:google-services:4.3.15'
    }
}

allprojects {
    repositories {
        google()
        jcenter()
    }
}

rootProject.buildDir = '../build'
subprojects {
    project.buildDir = "${rootProject.buildDir}/${project.name}"
}
subprojects {
    project.evaluationDependsOn(':app')
}

tasks.register("clean", Delete) {
    delete rootProject.buildDir
}

问题分析 #

这个错误属于类兼容性变更异常，核心原因是Release模式下R8代码压缩规则与依赖库的AndroidX版本冲突。错误日志指向的androidx.core.content.f是混淆后的类名（实际对应ContentProviderCompat或相关类），说明AndroidX Core库在Release字节码处理中出现了不兼容情况。Gradle 8.x对R8压缩的规则更严格，部分未适配的旧依赖库容易触发这类问题。

解决方案 #

1. 强制统一AndroidX Core版本 #

在项目根目录的build.gradle中添加强制依赖规则，确保所有依赖使用同一版本的AndroidX Core：

subprojects {
    configurations.all {
        resolutionStrategy.force 'androidx.core:core:1.12.0'
        resolutionStrategy.force 'androidx.core:core-ktx:1.12.0'
    }
}

版本号可替换为最新稳定版（如1.13.x）。

2. 调整R8混淆规则 #

在android/app/proguard-rules.pro中添加AndroidX Core的混淆排除规则：

-keep class androidx.core.content.** { *; }
-keep interface androidx.core.content.** { *; }
-keepclassmembers class androidx.core.content.** { *; }

若不确定具体类，可临时关闭R8压缩验证问题根源：
在android/app/build.gradle的buildTypes.release块中添加：

minifyEnabled false
shrinkResources false

关闭后若崩溃消失，说明是混淆规则问题，再逐步排查需要保留的具体类。

3. 排查依赖冲突 #

运行以下命令查看依赖树，找出AndroidX Core的版本冲突：

flutter pub deps --tree | grep "androidx.core"

将所有依赖的androidx.core版本统一为最新稳定版。

4. 排查适配异常的依赖库 #

部分旧依赖可能未适配Gradle 8.x，重点排查以下风险较高的依赖，尝试降级或替换：

• flutter_reactive_ble：BLE相关库常涉及ContentProvider
• local_auth：本地认证依赖AndroidX Core
• permission_handler：权限处理库与AndroidX交互频繁

可暂时移除这些依赖，重新打包Release版本验证是否能启动，逐步定位问题库。

5. 更新Gradle和Kotlin版本 #

尝试将Gradle升级到最新稳定版（如8.4），同步更新Kotlin到兼容版本（如1.9.20）：
修改根目录build.gradle：

ext.kotlin_version = '1.9.20'
dependencies {
    classpath 'com.android.tools.build:gradle:8.4.0'
    // 其他依赖保持不变
}

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