一对多XML映射需用findall()提取同名子节点并显式构建列表，避免find()只取首个；嵌套时须按层级路径查找，注意命名空间影响，且声明式映射需正确配置@XmlElement等注解。
一对多关系的 XML 数据映射，核心在于识别父元素与重复子元素的层级结构，并避免把 list 类型字段错误映射成单个对象。多数解析器（如 Java 的 JAXB、Python 的 xml.etree.ElementTree 或 lxml）默认不会自动聚合同名子节点为列表，需要显式处理。
如何识别并提取重复子节点
XML 中一对多通常表现为一个父标签下包含多个相同名称的子标签，例如 .find() 只会返回第一个匹配项，必须改用 .findall() 或等价方法。
-
.find("item")→ 返回第一个 -
.findall("item")→ 返回所有list - 若子元素嵌套更深（如
order/items/item），路径需写全，且注意命名空间影响
Python 示例：用 xml.etree.ElementTree 构建嵌套字典列表
手动映射时，关键逻辑是：对每个父节点，遍历其所有同名子节点，逐个解析并追加到列表中。不要试图用 dict() 直接转 —— 它无法区分“单个子元素”和“多个同名子元素”。
import xml.etree.ElementTree as ET
<p>xml_data = """<orders><order id="1001"><customer>Alice</customer><items><item sku="A001"><name>Book</name><qty>2</qty></item><item sku="B002"><name>Pen</name><qty>5</qty></item></items></order></orders>"""</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill9965" title="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20dbae7c507.jpg" alt="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill9965" title="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac" class="overflowclass">macOS UI 自动化技能包 —— 用 Python 控制你的 Mac</a>
<p class="overflowclass">让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript
系统要求
macOS 14+ (Sonoma)
Python 3.9+
需要开启：辅助功能 + 屏幕录制权限</p>
</div>
<a rel="nofollow" href="/xiazai/skill9965" title="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div><p>root = ET.fromstring(xml_data)
orders = []</p><p>for order_elem in root.findall("order"):
items = []
for item_elem in order_elem.find("items").findall("item"):
items.append({
"sku": item_elem.get("sku"),
"name": item_elem.find("name").text,
"qty": int(item_elem.find("qty").text)
})</p><pre class="brush:php;toolbar:false;">orders.append({
"id": order_elem.get("id"),
"customer": order_elem.find("customer").text,
"items": items
})
此时 orders 是含嵌套 list 的结构，可直接 JSON 序列化或入库
JAXB 或 Jackson XML 映射一对多时的常见陷阱
声明式映射（如 Java 的 @XmlElement）看似简单，但容易因注解位置或类型声明出错：
- Java 中
List字段必须配@XmlElement(name = "item")，不能只写@XmlElement - 如果子元素名和字段名不一致（如 XML 是
items），必须显式指定name属性 - 缺少无参构造函数或 getter/setter 会导致反序列化失败，错误信息常为
InstantiationException或空指针 - XML 中若某次没有
null而非空List，需用@XmlElementWrapper或初始化逻辑兜底
为什么不用 XPath 简单取全部 //item？
全局 XPath //item 能拿到所有
真正容易被忽略的是：XML 命名空间（xmlns）会让所有标签带前缀，此时 findall("item") 失效，必须注册命名空间并使用带前缀的路径，比如 findall("ns:item", namespaces={"ns": "http://example.com"})。没处理命名空间是一对多映射失败最隐蔽的原因之一。
