Android Studio Java项目修复SDK问题后仍构建失败求助

首先需要获取完整错误详情：当前仅展示了任务执行状态，没有给出具体错误栈，所有失败任务的共同根因会在详细错误信息中明确标注，你可以通过两种方式获取：

• 点击Android Studio构建窗口中每个FAILED任务左侧的展开箭头，复制完整错误描述
• 在终端进入项目根目录执行./gradlew assembleDebug --stacktrace，输出完整的调用栈信息

以下为对应8个失败任务的常见根因及解决方法：

1. 适配checkDebugAarMetadata失败问题 #

这一任务失败通常是SDK版本与依赖不匹配导致：

• 打开模块级app/build.gradle文件，确认compileSdkVersion、targetSdkVersion版本不低于你引入的所有第三方依赖要求的最低编译SDK版本，比如依赖要求compileSdk最低为34，你的配置为33就会触发报错
• 检查buildToolsVersion版本与compileSdk版本适配，建议使用与compileSdk同版本的最新稳定版构建工具

2. 适配processDebugMainManifest失败问题 #

这一任务失败通常是清单文件配置错误或合并冲突导致：

• 检查AndroidManifest.xml中所有四大组件是否显式配置了android:exported属性（Android 12及以上版本强制要求）
• 检查是否存在多个子模块/依赖的清单文件属性冲突，错误日志中会明确给出冲突的属性值以及冲突来源

3. 适配mergeDebugResources、mergeDebugAssets失败问题 #

这两类任务失败通常是资源文件错误导致：

• 检查res目录下所有资源文件名是否符合规范：不能包含大写字母、空格、特殊字符，不同维度资源文件夹下不能存在同名且格式不同的资源
• 检查assets目录下是否存在文件损坏、名称冲突的问题

4. 适配checkDebugDuplicateClasses、desugarDebugFileDependencies、mergeDebugNativeLibs、mergeDebugJavaResource失败问题 #

这四类任务失败通常是依赖冲突导致：

• 执行./gradlew app:dependencies命令查看依赖树，排查是否存在同一个库引入了多个不同版本的情况，找到冲突后在app/build.gradle的依赖配置中通过exclude规则移除重复依赖
• 如果是原生so库冲突，可在android闭包下添加packagingOptions配置处理冲突：

android {
    packagingOptions {
        pickFirst 'lib/arm64-v8a/libxxx.so' // 保留第一个遇到的冲突so文件
        exclude 'META-INF/*' // 排除重复的声明文件
    }
}

• 确认已开启Java 8+编译支持，在app/build.gradle中添加如下配置：

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

5. 缓存问题通用解决方案 #

如果以上配置都没有发现问题，尝试清理缓存后重新构建：

• 点击Android Studio菜单栏 File -> Invalidate Caches...，勾选清除文件系统缓存和本地历史，点击重启IDE
• 重启后在终端执行./gradlew clean清理项目构建缓存，再重新运行构建任务

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