新建Android项目时Manifest第5行2列报XML结构实体匹配错误

解决方案 #

你贴出的主AndroidManifest.xml结构完全符合规范，报错并不来自这个文件，是Manifest合并流程、IDE缓存或依赖兼容问题导致的，按以下步骤逐一排查即可解决：

• 清理IDE缓存并重启
  点击Android Studio顶部菜单栏 File → Invalidate Caches...，勾选Clear file system cache and local history、Clear downloaded shared indexes两个选项，点击Invalidate and Restart，等待IDE重启完成后重新构建项目。
• 校验Gradle版本兼容性
  确认项目的Android Gradle Plugin（AGP）版本与Gradle版本匹配，避免版本不兼容导致的合并异常：AGP版本定义在项目根目录build.gradle的com.android.tools.build:gradle依赖项中，Gradle版本定义在gradle/wrapper/gradle-wrapper.properties的distributionUrl字段中，两者的对应关系可查询Android Studio官方版本匹配文档。如果是刚升级过Android Studio，建议将项目的compileSdk、targetSdk调整为当前IDE支持的稳定正式版，不要使用预览版SDK。
• 排查第三方依赖的Manifest问题
  报错大概率是引入的第三方依赖库的Manifest结构异常导致合并失败，先暂时注释掉app模块build.gradle中新增的非官方依赖，同步Gradle后验证问题是否消失，逐步定位出问题的依赖项即可。
• 修复损坏的IDE索引
  打开项目根目录的.idea文件夹，删除caches、libraries两个子文件夹，再重新同步Gradle项目，修复损坏的本地索引文件。
• 解决Design视图渲染异常
  上述操作完成后如果还有RENDER PROBLEM问题，将androidx.constraintlayout:constraintlayout依赖升级到最新稳定版，同时将布局预览页面右上角的预览API版本调整为31及以下的稳定正式版，不要使用预览版API做布局预览。

内容的提问来源于stack exchange，提问作者Tamzid Israk Adol