Flutter运行Android模拟器报错：:app:dexBuilderDebug执行失败

AI 小北

2026-7-3

解决Flutter Android构建:app:dexBuilderDebug错误及R8循环引用问题

核心错误表现

运行Flutter项目到Android模拟器时，出现构建失败：

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':app:dexBuilderDebug'.
> There were multiple failures while executing work items
   > A failure occurred while executing com.android.build.gradle.internal.dexing.DexWorkAction
      > Failed to process: project_path/android/app/build/intermediates/transforms/APMSPlugin/debug/246, project_path/android/app/build/intermediates/transforms/APMSPlugin/debug/247

伴随R8循环引用异常：

Caused by: java.util.concurrent.ExecutionException: com.android.tools.r8.kotlin.H
Caused by: [CIRCULAR REFERENCE: com.android.tools.r8.kotlin.H]

可行解决方案

清理构建缓存
执行以下命令彻底清理缓存后重新构建：
```
flutter clean
rm -rf android/app/build
flutter run
```
也可在Android Studio中操作：Build -> Clean Project → Build -> Rebuild Project
临时关闭R8优化（Debug模式）
在android/app/build.gradle的buildTypes下修改debug配置，禁用R8和混淆：
```
debug {
    minifyEnabled false
    useProguard false
    shrinkResources false
}
```
排查APMSPlugin依赖问题
错误日志指向APMSPlugin的处理失败，尝试：
- 暂时移除项目中APMS相关的插件或依赖，验证是否能正常构建
- 若必须使用该插件，升级到兼容Flutter 3.16.4的最新版本
调整Gradle到兼容版本
Flutter 3.16.4推荐搭配Gradle 8.0 + Android Gradle Plugin 8.1.0，避免直接升级到过高版本：
1. 修改android/gradle/wrapper/gradle-wrapper.properties：
```
distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-all.zip
```
2. 修改android/build.gradle中的AGP版本：
```
dependencies {
    classpath 'com.android.tools.build:gradle:8.1.0'
}
```
3. 执行flutter pub get后重新构建
匹配Kotlin版本
在android/build.gradle中指定与当前环境兼容的Kotlin版本：
```
ext.kotlin_version = '1.9.20'
```