安卓开发： Dex 合并过程中发生了异常 , 导致项目无法正常编译-CSDN博客

本文链接：https://blog.csdn.net/loveryunz/article/details/147747884

请添加图片描述

as报错日志一：

A failure occurred while executing com.android.build.gradle.internal.tasks.DexMergingTaskDelegate
There was a failure while executing work items
A failure occurred while executing com.android.build.gradle.internal.tasks.DexMergingWorkAction
com.android.builder.dexing.DexArchiveMergerException: Error while merging dex archives:

as报错日志二：

Task :bpack:mergeExtDexDebug
AGPBI: {“kind”:“error”,“text”:“java.lang.OutOfMemoryError: Java heap space”,“sources”:[{}],“tool”:“D8”}
com.android.builder.dexing.DexArchiveMergerException: Error while merging dex archives:
at com.android.builder.dexing.D8DexArchiveMerger.getExceptionToRethrow(D8DexArchiveMerger.java:151)
at com.android.builder.dexing.D8DexArchiveMerger.mergeDexArchives(D8DexArchiveMerger.java:138)
at com.android.build.gradle.internal.tasks.DexMergingWorkAction.merge(DexMergingTask.kt:859)

这两个报错都是因为在合并 dex 文件时发生了异常导致的崩溃，这是 Android 编译过程中比较常见的问题，原因可能有以下几种：

✅ 常见原因及解决方案

依赖冲突（同一个类在多个库中）
某些库中包含了相同的类，导致 Dex 无法合并。

解决方法：使用 ./gradlew app:dependencies 命令检查依赖冲突。排除重复依赖

例如：

implementation('com.example:libA:1.0.0') {
    exclude group: 'com.duplicate', module: 'duplicate-lib'
}

方法数超过 65,536（未启用 MultiDex），Dex 有方法数量限制，超出后需开启 MultiDex。

解决方法：

defaultConfig {
    multiDexEnabled true
}

dependencies {
    implementation 'androidx.multidex:multidex:2.0.1'
}

编译缓存问题，有时构建缓存或中间文件损坏。

解决方法：

./gradlew clean
./gradlew build --no-build-cache

在项目的 gradle.properties 文件中添加或修改以下配置：

org.gradle.jvmargs=-Xmx4096m

-Xmx4096m 表示最大堆内存为 4GB。你可以根据你的电脑内存情况设置，比如 2048m, 4096m, 或更高。

启 R8 代码收缩（如果未开启）, 在 build.gradle 中确保启用了代码压缩，以减少 dex 大小：

android {
    buildTypes {
        debug {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

注意：开启混淆后，调试版本可能不易调试，请根据需要开启。