XML文件如何合并多个Root节点 解决XML文档仅允许一个根元素

XML文档的语法规范明确要求整个文档只能存在一个顶级根元素，如果XML文件包含多个并列的根节点，在解析时就会抛出仅允许一个根元素的错误。这种情况常出现在多个XML片段拼接、第三方系统返回不规范XML结果的场景中，需要手动将多个根节点合并到同一个新的根节点下才能正常解析。

XML单根节点规范说明

合法的XML文档结构必须遵循以下层级规则：

• 文档开头可以有XML声明，声明不属于根节点的一部分
• 整个文档只能有一个最外层的根元素，所有其他元素都必须是该根元素的子节点
• 根元素必须正确闭合，不能和其他元素交叉嵌套

例如下面是一个合法的XML文档，只有一个<root>根节点：

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <user>
        <name>张三</name>
        <age>20</age>
    </user>
</root>

如果文档变成下面这样，就存在两个根节点<user>和<order>，属于不合法的XML：

<?xml version="1.0" encoding="UTF-8"?>
<user>
    <name>张三</name>
    <age>20</age>
</user>
<order>
    <id>1001</id>
    <price>99.9</price>
</order>

多根节点合并的实现思路

合并多个根节点的核心逻辑是创建一个新的统一根元素，然后将原有所有根节点的子元素或者根节点本身移动到新根节点下，最后重新生成符合规范的XML文档。实现步骤如下：

1. 读取原始的不规范XML内容，处理掉可能存在的XML声明
2. 将XML内容包裹在一个临时的外层标签中，让文档暂时符合单根规范，方便解析
3. 解析临时XML文档，获取所有原根节点
4. 创建新的目标根节点，将原根节点依次添加到新根节点下
5. 导出新的XML内容，添加XML声明后输出

Python实现多根节点合并示例

使用Python内置的xml.etree.ElementTree库可以很方便地实现上述逻辑，以下是完整的代码示例：

import xml.etree.ElementTree as ET
from xml.dom import minidom

def merge_xml_roots(xml_content, new_root_tag="root"):
    """
    合并XML文档中的多个根节点
    :param xml_content: 原始XML字符串内容
    :param new_root_tag: 新生成的根节点标签名
    :return: 合并后的合法XML字符串
    """
    # 去除可能存在的XML声明，避免重复添加
    if xml_content.startswith("<?xml"):
        # 找到第一个>的位置，截取声明之后的内容
        decl_end = xml_content.index(">") + 1
        xml_decl = xml_content[:decl_end]
        xml_body = xml_content[decl_end:].strip()
    else:
        xml_decl = '<?xml version="1.0" encoding="UTF-8"?>'
        xml_body = xml_content.strip()
    
    # 用临时标签包裹内容，让文档可以正常解析
    temp_xml = f"<temp>{xml_body}</temp>"
    
    try:
        # 解析临时XML
        root = ET.fromstring(temp_xml)
    except ET.ParseError as e:
        raise ValueError(f"XML解析失败: {e}")
    
    # 创建新的根节点
    new_root = ET.Element(new_root_tag)
    
    # 将原根节点（temp的子节点）全部移动到新根节点下
    for child in root:
        new_root.append(child)
    
    # 生成XML字符串并美化格式
    rough_xml = ET.tostring(new_root, encoding="utf-8")
    reparsed = minidom.parseString(rough_xml)
    pretty_xml = reparsed.toprettyxml(indent="    ")
    
    # 拼接XML声明和美化后的内容，去除多余的空行
    final_lines = [line for line in pretty_xml.split("n") if line.strip()]
    # 替换默认声明的编码为UTF-8，和我们的声明保持一致
    if final_lines[0].startswith("<?xml"):
        final_lines[0] = xml_decl
    
    return "n".join(final_lines)

# 测试示例：包含多个根节点的XML内容
test_xml = """<user>
    <name>张三</name>
    <age>20</age>
</user>
<order>
    <id>1001</id>
    <price>99.9</price>
</order>"""

# 调用合并方法
merged_xml = merge_xml_roots(test_xml)
print(merged_xml)

运行上述代码后，输出的合并后XML内容如下，可以看到两个原根节点都被合并到了新的<root>根节点下：

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <user>
        <name>张三</name>
        <age>20</age>
    </user>
    <order>
        <id>1001</id>
        <price>99.9</price>
    </order>
</root>

注意事项

• 如果原始XML内容本身已经符合单根规范，上述方法也会正常处理，只是会新增一个外层根节点，使用前可以先判断是否存在多个根节点
• 如果原XML中包含命名空间，需要注意命名空间的传递，避免合并后命名空间丢失
• 对于超大XML文件，不建议一次性读取全部内容到内存，可以采用流式解析的方式逐段处理

XML根节点合并XML解析Python_XMLElementTree修改时间：2026-07-10 04:06:26