Android Studio构建项目报XIncludeAwareParserConfiguration类转换错误如何解决

该报错为xerces XML解析库的类加载冲突：相同类被两个不同的Gradle类加载器实例加载，导致类型无法匹配转型。你已经尝试过的清缓存、杀Gradle进程方案无效的情况下，按以下步骤排查解决：

• 排除全局Gradle与项目内的xerces传递依赖 #

  首先检查用户目录下.gradle/init.d路径的全局初始化脚本，若存在引入xerces相关依赖的脚本，先移出该目录。
  再在项目根目录build.gradle文件中添加全局排除规则：

  buildscript {
      configurations.all {
          exclude group: 'xerces', module: 'xercesImpl'
          exclude group: 'xml-apis', module: 'xml-apis'
      }
      // 原有其他配置保持不变
  }
  
  allprojects {
      configurations.all {
          exclude group: 'xerces', module: 'xercesImpl'
          exclude group: 'xml-apis', module: 'xml-apis'
      }
      // 原有其他配置保持不变
  }
  

  修改后重新同步项目验证。

• 清理全局Gradle缓存 #

  手动删除用户目录下整个.gradle/caches文件夹，该操作会清除所有项目的Gradle依赖缓存，删除后重启Android Studio重新同步项目，会自动重新下载所需依赖。

• 验证插件与Gradle版本兼容性 #

  若你近期修改过AGP版本、Gradle版本，或新增过第三方Gradle插件：
  • 回滚到修改前的AGP、Gradle版本，确认版本匹配关系正确
  • 临时注释掉近期新增的第三方Gradle插件引入代码，逐一验证是否为插件携带的依赖导致冲突

• 强制统一xerces依赖版本 #

  以上步骤无效时，在根目录build.gradle的buildscript依赖块中强制指定统一版本的xerces依赖：

  buildscript {
      dependencies {
          classpath 'xerces:xercesImpl:2.12.2'
          classpath 'xml-apis:xml-apis:1.4.01'
          // 原有其他classpath配置保持不变
      }
  }
  

  修改后重新同步项目即可。

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