Cordova项目编译报错：aapt执行失败，仅单个项目受影响

遇到这个问题确实闹心——只有单个项目卡在资源处理步骤，其他项目都正常，说明大概率是这个项目本身的配置、资源或者依赖出了问题。我整理了几个针对性的排查方向，你可以一步步试：

1. 排查资源文件的合规性 #

:processArm64DebugResources本质是处理Android资源文件，所以首先要检查项目里的资源有没有问题：

• 去项目的platforms/android/app/src/main/res目录，检查所有资源文件（比如drawable里的图片、layout/xml文件）：
  • 文件名是否符合Android规范：只能用小写字母、数字、下划线_和连字符-，不能有中文、空格或大写字母；
  • 图片文件是否损坏：可以尝试替换几张新增的图片，或者用图片工具打开确认；
  • XML资源是否有语法错误：比如标签没闭合、属性写错，用Android Studio打开这个Android项目，它会自动高亮错误位置。

2. 检查Gradle依赖与版本冲突 #

虽然其他项目正常，但这个项目的插件可能引入了冲突的依赖，或者Gradle版本不兼容：

• 打开platforms/android/build.gradle，确认compileSdkVersion、targetSdkVersion和你当前使用的Cordova版本匹配（比如Cordova 11对应compileSdk 30，Cordova 12对应32）；
• 执行命令cd platforms/android && ./gradlew app:dependencies查看依赖树，找有没有同一个库出现多个版本的情况。如果有冲突，可以在build.gradle的configurations.all里添加resolutionStrategy强制统一版本，比如：

  configurations.all {
      resolutionStrategy.force 'com.example:library:1.2.3'
  }
  

3. 彻底清理构建缓存 #

有时候cordova clean不够彻底，Android的Gradle缓存可能残留了错误数据：

• 先进入Android平台目录执行深度清理：cd platforms/android && ./gradlew cleanBuildCache；
• 回到项目根目录，再执行cordova clean，然后重新尝试构建；
• 如果还是不行，可以手动删除本地Gradle缓存目录~/.gradle/caches（注意这会清空所有项目的Gradle缓存，下次构建其他项目会慢一点，但能彻底解决缓存问题）。

4. 检查ARM64架构相关配置 #

报错针对Arm64架构，可能是项目或插件对该架构的支持有问题：

• 打开platforms/android/app/build.gradle，检查ndk.abiFilters配置，如果你的项目不需要支持arm64-v8a，可以暂时去掉这个架构，看看能不能构建成功；
• 确认所有插件都支持arm64架构，有些旧插件可能只有armeabi-v7a的资源，尝试把插件更新到最新版本，或者替换为支持多架构的插件。

5. 验证Android SDK组件完整性 #

虽然其他项目正常，但这个项目可能需要特定的SDK组件：

• 打开Android SDK Manager，检查对应compileSdkVersion的SDK Platform、Build Tools是否安装完整；
• 如果项目用到了NDK，确认NDK版本和项目配置匹配，没有缺失组件。

如果以上方法都没解决，你可以尝试逐步迁移排查：创建一个新的空白Cordova项目，先添加相同的平台，再逐个添加原项目的插件、复制代码和资源，每一步都尝试构建，这样就能定位到具体是哪个插件或资源导致的问题。

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