Gradle 7.4.2打包报错：无法覆盖META-INF/MANIFEST.MF

以下是针对该问题的具体排查和解决步骤：

1. 校验Gradle版本兼容性 #

Android Studio Hedgehog 官方对应Gradle插件版本为8.2.x，你当前使用的Gradle 7.4.2版本过低，版本不匹配极易引发构建逻辑冲突：

• 修改项目根目录gradle/wrapper/gradle-wrapper.properties中的distributionUrl：

  distributionUrl=https\://services.gradle.org/distributions/gradle-8.2-bin.zip
  

• 修改项目根目录build.gradle（或build.gradle.kts）的插件版本：

  dependencies {
      classpath 'com.android.tools.build:gradle:8.2.2'
  }
  

• 同步项目后重新尝试构建。

2. 彻底清理构建缓存与临时文件 #

仅删除APK无法解决缓存残留问题，执行以下操作：

• 在Android Studio中点击File > Invalidate Caches...，勾选Invalidate and Restart重启IDE。
• 手动删除项目根目录下的.gradle文件夹、模块目录下的build文件夹。
• 执行命令行清理：

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

3. 排查第三方依赖的重复META-INF文件 #

部分第三方库会自带META-INF/MANIFEST.MF，导致打包时冲突。在模块的build.gradle中添加打包配置：

android {
    packagingOptions {
        // 直接排除所有重复的MANIFEST文件
        exclude 'META-INF/MANIFEST.MF'
        // 若需保留部分库的MANIFEST，改用pickFirst
        // pickFirst 'META-INF/MANIFEST.MF'
    }
}

如果还有其他META-INF相关冲突，可一并添加排除规则，比如exclude 'META-INF/*.SF'、exclude 'META-INF/*.RSA'。

4. 检查Release签名配置 #

确保Release版本签名配置无重复或错误，避免重复签名操作引发文件冲突：

android {
    signingConfigs {
        release {
            storeFile file("your-keystore.jks")
            storePassword "your-store-password"
            keyAlias "your-key-alias"
            keyPassword "your-key-password"
        }
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

确认签名文件路径、密码无误，且无重复的签名配置项。

5. 禁用增量构建 #

增量构建可能引发缓存逻辑异常，尝试关闭增量构建：
在模块的build.gradle中添加：

android {
    tasks.withType(JavaCompile) {
        options.incremental = false
    }
}

或执行构建时添加参数：

./gradlew assembleRelease --no-incremental

如果以上步骤均无法解决问题，请提供模块build.gradle的完整内容（重点是android和dependencies块），以便进一步定位问题。

内容的提问来源于stack exchange，提问作者Phil T.