Android Studio构建失败报错app:processDebugResources,aapt2 POM文件prolog异常

云原生阿岚

2026-10-19

修复方案

该报错的核心原因是本地Gradle缓存的com.android.tools.build:aapt2:4.2.1-7147631依赖对应的pom文件下载损坏，XML文件头存在非法内容无法解析，按照以下步骤操作即可解决：

第一步：关闭Android Studio，找到本地Gradle缓存目录
- Windows系统路径：C:\Users\你的系统用户名\.gradle\caches
- macOS/Linux系统路径：~/.gradle/caches
  在caches文件夹中搜索所有带aapt2-4.2.1-7147631关键词的文件和文件夹，全部删除

第二步：修改项目仓库配置避免下载失败
打开项目根目录下的settings.gradle文件（旧版Android Studio项目为根目录下的build.gradle文件），在repositories节点中优先配置国内镜像，参考配置如下：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/maven2' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        // 保留原有其他仓库配置即可
    }
}

第三步：重启Android Studio并清除本地缓存
打开Android Studio后点击顶部菜单栏 File → Invalidate Caches...，勾选Clear file system cache and local history选项，点击Invalidate and Restart等待IDE重启
第四步：重新同步项目依赖
重启后等待IDE自动同步项目，若未触发自动同步可手动点击右上角的Sync Project with Gradle Files按钮，待所有依赖重新下载完成后再执行构建操作即可正常运行