Android构建报错：:app:processDebugResources任务执行失败

问题原因 #

出现Aapt2Exception是因为项目资源文件中缺少color/purple_500、purple_700、teal_200等Material Design默认颜色资源，而主题或布局中又引用了这些资源，导致资源链接阶段失败。

解决方案 #

• 补全缺失的颜色资源
  找到项目对应的颜色资源文件，分别在res/values/colors.xml和res/values-night-v8/colors.xml（或res/values-night/colors.xml）中添加缺失的颜色定义：

  <!-- res/values/colors.xml -->
  <resources>
      <!-- 保留原有颜色，添加以下缺失项 -->
      <color name="purple_500">#6200EE</color>
      <color name="purple_700">#3700B3</color>
      <color name="purple_200">#BB86FC</color>
      <color name="teal_200">#03DAC5</color>
      <color name="teal_700">#018786</color>
  </resources>
  

  <!-- res/values-night-v8/colors.xml -->
  <resources>
      <!-- 夜间模式颜色可按需调整，确保名称匹配即可 -->
      <color name="purple_500">#BB86FC</color>
      <color name="purple_700">#3700B3</color>
      <color name="purple_200">#6200EE</color>
      <color name="teal_200">#03DAC5</color>
      <color name="teal_700">#018786</color>
  </resources>
  

• 修正主题中的资源引用
  打开res/values/styles.xml及夜间模式主题文件，检查是否有引用这些缺失的颜色。如果不需要使用这些默认颜色，直接将引用替换为项目中已有的颜色资源即可。例如：

  <style name="AppTheme" parent="Theme.MaterialComponents.DayNight.DarkActionBar">
      <!-- 替换为你项目的自定义主色调 -->
      <item name="colorPrimary">@color/your_custom_primary</item>
      <item name="colorPrimaryVariant">@color/your_custom_primary_variant</item>
      <item name="colorSecondary">@color/your_custom_secondary</item>
  </style>
  

• 清理缓存并重新构建
  执行以下操作清除构建缓存，避免旧缓存干扰：

  # 命令行方式
  ./gradlew clean
  ./gradlew assembleDebug
  

  或者在Android Studio中点击Build > Clean Project，随后点击Build > Rebuild Project。

• 排查依赖冲突
  如果是引入第三方库后出现的问题，检查app/build.gradle中的依赖项，排除可能携带冲突资源的库，或升级相关依赖到稳定版本。

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