页面标题里写R&D很常见,把它原样放进XML普通文本,却可能立刻报解析错误。2026年11月18日,在XML格式化工具输入:

<note>R&D</note>

单击“校验 / 格式化”,本次错误提示指向实体相关内容,原输入仍保留在编辑区。

裸&使本次XML普通文本解析失败,编辑区仍保留原输入
裸&使本次XML普通文本解析失败,编辑区仍保留原输入

文本中的&要用实体引用表示

在XML普通字符数据里,&不是随意出现的普通符号,它会开始一个实体引用或字符引用。R&D里的&后面并没有形成合法引用,所以解析不能按预期完成。

把输入改成下面这样,再执行一次:

<note>R&amp;D</note>
使用amp实体引用后,本次格式化成功并保留相应源写法
使用amp实体引用后,本次格式化成功并保留相应源写法

这次工具输出了XML声明和note元素,源文本中的&amp;仍是引用写法。解析后,note的文字内容是R&D;并不是要求业务名称改叫“R amp D”。源文件表示方式和解析后字符,需要分开看。

这里讨论的是普通文本。CDATA区有自己的边界规则,不能据此认定XML文件里的每一个&都必须再替换一次。已有引用、属性值和业务数据也应由合适的XML序列化器处理,而不是直接对整份报文做字符串替换。

不要把已经转义的内容再处理一遍

如果上游给出的已经是R&amp;D,再不加区分地替换所有&,就可能得到R&amp;amp;D。解析一次后,文字会保留“&amp;”这一段,而不是最初希望的单个&。

排查时先确认上游交来的值是什么:业务原文R&D,还是已经带引用的XML片段。前者交给XML序列化器转义一次;后者如果需要作为结构使用,就要按片段解析规则处理,不能把两种输入混成同一层。

同样,日志、浏览器页面和编辑器可能各自有显示转义。看到“&amp;”不一定代表数据被重复处理,应保存实际XML字节,再核对解析后的文本值。只凭截图中多了几个字母,很难判断是哪一层负责显示。

能解析以后,还要核对字段内容

本次修正只解决普通文本中的实体引用问题,没有校验业务字段是否符合接口要求。格式化成功,也不能代替DTD、Schema或应用侧的字段约定。

复制结果前,先确认元素名称、文本和层级符合原协议。需要整理其他XML报文,可参考XML校验与格式化的基本操作;遇到类似R&D的内容,保留原值与序列化结果的对照,比反复替换字符更容易确认是否只处理了一次。