Android Studio 3.1升级后Aapt2报错及无法运行应用求助

我之前帮好几个开发者解决过这个问题，核心原因是AAPT2对资源的检查比旧版AAPT严格太多——升级后项目里一些之前被忽略的资源小问题直接触发了构建失败，而禁用AAPT2只是临时的权宜之计，不仅有官方警告，还会导致应用无法正常运行，所以必须彻底解决根源问题。下面是一步步的排查修复方案：

1. 先启用AAPT2（关键第一步） #

先把gradle.properties里的android.enableAapt2=false删掉，或者改成android.enableAapt2=true。只有启用它，你才能看到具体的错误根源，不然永远找不到问题所在。

2. 查看完整的AAPT2错误日志 #

构建失败时别只看控制台的简略报错，切换到详细日志找问题：

• 在Android Studio的Build窗口，点击左上角的「Toggle View」图标（列表样式），切换到Build Output视图，这里会明确显示AAPT2在处理哪个资源文件时出错。
• 最常见的错误点包括：
  • 资源文件名包含大写字母（AAPT2严格要求资源文件名必须全小写，旧版AAPT允许大写）
  • XML资源存在语法错误，比如未闭合的标签、属性值引号不匹配
  • 矢量图（Vector Drawable）里的路径语法错误
  • 字符串资源里有未转义的特殊字符，比如&、<，需要替换成&、<

举个典型错误示例：

error: resource drawable/MyIcon (aka com.example.app:drawable/MyIcon) not found.

这种情况大概率是图标文件名用了大写，改成my_icon.png或myicon.png就能解决。

3. 清理缓存并重建项目 #

找到并修复资源错误后，执行以下操作彻底清除旧缓存：

• 点击菜单栏的Build > Clean Project
• 再点击Build > Rebuild Project
• 还可以手动删除项目根目录下的.gradle文件夹和app/build文件夹，再重新构建

4. 检查Gradle插件与Gradle版本匹配 #

Android Studio 3.1对应的Gradle插件版本建议用3.1.0_{`3.1.4`，Gradle版本对应`4.4`}4.7，版本不匹配也会触发AAPT2兼容性问题：

• 项目根目录build.gradle里的插件版本：

buildscript {
    dependencies {
        classpath 'com.android.tools.build:gradle:3.1.4' // 确保是3.1.x系列
    }
}

• gradle/wrapper/gradle-wrapper.properties里的Gradle版本：

distributionUrl=https\://services.gradle.org/distributions/gradle-4.7-all.zip

5. 处理第三方资源的兼容性 #

如果项目用到了第三方库或自定义资源工具，也可能和AAPT2冲突：

• 升级第三方库到支持AAPT2的最新版本
• 比如用ButterKnife这类注解库，要确保版本和Gradle插件兼容（ButterKnife 8.8.1及以上支持Gradle 3.x）

最后验证 #

修复完所有问题后重新构建项目，应该就能正常编译，并且可以在实体机和模拟器上运行了。如果还是有问题，再仔细查看Build Output里的错误信息，定位到具体资源文件逐一排查即可。

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