XML文档必须且只能有一个根元素，根元素外不能有任何字符（包括空格、换行、BOM或注释）；常见错误是根标签后存在隐藏字符、多个顶层元素、动态生成时的意外输出，需用工具校验并清理。
这个错误说明XML文档在根元素之后还有额外内容，违反了XML规范——一个合法的XML文档只能有一个根元素，且根元素之外不能有任何字符（包括空格、换行、注释或文本）。
检查根元素外的多余字符
最常见的原因是根标签闭合后多了一个换行、空格或BOM（字节顺序标记）。用文本编辑器以“显示所有字符”模式打开文件，查看根元素结束标签（如）后面是否紧跟着不可见字符。特别注意Windows记事本保存时可能自动添加UTF-8 BOM（EF BB BF），它位于文件开头，但有时也会干扰解析逻辑；更常见的是末尾多出的回车或空格。
确认没有多个根节点
XML不允许并列的顶层元素。以下写法是非法的：
必须用一个父元素包裹：
排查隐藏的输出或拼接问题
如果是程序动态生成XML（比如PHP echo、Java StringBuilder、Python f-string），检查是否有意外的print、log、echo语句在根元素前后执行，或者字符串拼接时多加了换行符或HTML片段。例如：
- PHP中
echo "";后又echo "，但中间没控制好换行... "; - 模板引擎（如Jinja2）里写了
{{ xml_content }}，末尾的
用工具验证和清理
复制XML内容到在线校验器（如XML Validation by W3C或XMLLint），它会准确定位非法字符位置。本地可用命令行快速清理：
- Linux/macOS：
sed -e ':a' -e '/^\s*$/{$d;N;ba' -e '}' file.xml | sed '/^$/d' | sed 's/[[:space:]]*$//' > clean.xml（删除末尾空白行和行尾空格） - 或直接用Python一行修复：
python3 -c "import sys; print(open(sys.argv[1]).read().strip())" bad.xml > clean.xml
基本上就这些。核心就是：一个根、零冗余、无BOM、无意外输出。
