Android Studio生成APK报transformClassesWithDexBuilderForDebug错误求助

报错信息 #

* What went wrong:
Execution failed for task ':app:transformClassesWithDexBuilderForDebug'.
> com.android.build.api.transform.TransformException: com.android.builder.dexing.DexArchiveBuilderException: com.android.builder.dexing.DexArchiveBuilderException: Failed to process /Users/mohammad/.gradle/caches/transforms-2/files-2.1/2a8ecf8990ef0fa0c976a742db5c3bdc/jars/classes.jar

可尝试的修复方案 #

• 检查Java版本兼容性
  该报错大概率是Android Gradle插件（AGP）版本和项目使用的JDK版本不匹配导致的：
  • AGP 7.0+要求使用JDK 11及以上版本，AGP 8.0+要求使用JDK 17及以上版本
  • 可以在Android Studio的File -> Project Structure -> SDK Location -> Gradle Settings里修改对应JDK版本，同时在app模块的build.gradle文件中统一编译版本：

    android {
        compileOptions {
            sourceCompatibility JavaVersion.VERSION_11 // 对应你的JDK版本
            targetCompatibility JavaVersion.VERSION_11
        }
        // 用Kotlin的话需要加下面的配置
        kotlinOptions {
            jvmTarget = "11"
        }
    }
    

• 检查MultiDex配置是否正确
  如果项目方法数超过65536未正确配置MultiDex也会触发该类错误：
  • 在app模块build.gradle的defaultConfig块中添加multiDexEnabled true
  • 若minSdk版本小于21，需要额外引入MultiDex依赖：implementation 'androidx.multidex:multidex:2.0.1'，同时在自定义Application类中初始化MultiDex
• 排查依赖冲突
  执行命令./gradlew app:dependencies打印完整依赖树，排查是否存在同一依赖库的多个版本冲突，对冲突的依赖做exclude处理，示例：

  implementation('com.example:some-lib:1.0.0') {
      exclude group: 'com.android.support', module: 'support-v4'
  }
  

• 执行完整清理构建
  除了删除全局gradle缓存，还需要删除项目根目录下的.gradle文件夹、app模块下的build文件夹，之后重新sync项目，再执行./gradlew clean assembleDebug命令编译
• 临时关闭混淆测试
  把debug构建类型的minifyEnabled和shrinkResources都设为false，若可以正常编译则说明是混淆规则缺失，需要对应补充引入的第三方依赖的官方混淆规则
• 检查本地依赖完整性
  如果项目有引入本地jar/aar依赖，检查对应文件是否损坏，可重新下载替换后再尝试编译

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