Android资源编译失败 报错XML或文本声明不在实体起始位置如何解决
Android资源编译报「XML或文本声明不在实体起始位置」排查方案
报错根本原因
XML语法规则明确约束:<?xml ...?>格式的版本/编码声明,必须放置在整个XML文档的最起始位置,前面不能有任何字符、空白内容、其他标签,绝对不能在任意节点内部重复出现这类声明,否则就会直接抛出「XML或文本声明不在实体起始位置」的编译错误。
现有布局代码中,直接触发报错的问题是:在根标签ConstraintLayout的开标签内部,重复放置了一段XML声明语句,完全违反XML语法要求。
修正操作步骤
- 删除位置错误的冗余声明:定位到
ConstraintLayout开标签后面的这段非法代码,直接删除即可,整个XML文件仅需在最顶部保留一次编码声明即可。需要删除的非法代码片段:
<!-- 这段代码在根布局内部,完全多余且非法 --> <?xml version = "1.0" encoding="utf-8"?> - 顺带修正布局结构缺陷:原代码在
ConstraintLayout内部嵌套了LinearLayout,但没有给该LinearLayout设置任何约束属性,即使删除冗余声明能通过编译,运行时也会出现布局位置偏移、宽高不符合预期的问题。可以选择给嵌套的LinearLayout补上对应的约束规则,也可以直接删掉最外层多余的ConstraintLayout,减少不必要的布局层级。 - 排查同类潜在语法问题:
- 遍历项目中所有XML类型的资源文件(布局、drawable、菜单、配置类xml等),确认没有在文档非起始位置放置XML声明的情况
- 检查报错XML文件的开头,有没有隐藏的BOM头、全角空格、不可见空白字符,这类隐藏内容同样会触发位置校验失败的报错
- 禁止在XML节点的标签内部、属性值中间穿插
<?...?>格式的声明语句
内容的提问来源于stack exchange,提问作者Amichai
相关产品推荐
相关产品推荐

