本文详解 JAXB 在处理带命名空间的嵌套 XML 元素（如 <opakowania> 下的 <opakowanie> 列表）时返回 null 的根本原因，并提供基于 package-info.java 的标准、可靠解决方案。
本文详解 jaxb 在处理带命名空间的嵌套 xml 元素（如 `
JAXB 默认对 XML 命名空间（namespace）极为敏感。当 XML 文档声明了默认命名空间（如 xmlns="http://rejestrymedyczne.ezdrowie.gov.pl/rpl/eksport-danych-v1.0"），所有未显式加前缀的元素均属于该命名空间。而若 Java 类未统一、正确地声明命名空间上下文，JAXB 解析器将无法匹配元素，导致 @XmlElement 绑定失败——最典型表现即 List<T> 字段为 null，即使 XML 中存在对应结构。
核心问题在于：单个类上分散设置 namespace 属性（如 @XmlRootElement(namespace=...) 或 @XmlElement(namespace=...)）极易遗漏或不一致，尤其在嵌套层级较深时（如 produktyLecznicze → produktLeczniczy → opakowania → opakowanie），任一环节缺失命名空间声明都会中断绑定链。
✅ 正确做法是采用 包级命名空间声明，通过 package-info.java 统一定义整个包的默认命名空间行为：
// package-info.java（必须位于实体类所在包的根目录）
@jakarta.xml.bind.annotation.XmlSchema(
namespace = "http://rejestrymedyczne.ezdrowie.gov.pl/rpl/eksport-danych-v1.0",
elementFormDefault = XmlNsForm.QUALIFIED
)
package com.yourpackage.model;
import jakarta.xml.bind.annotation.XmlNsForm;⚠️ 注意：elementFormDefault = XmlNsForm.QUALIFIED 表示所有局部元素（非顶层 @XmlRootElement）也需按命名空间限定解析——这正是匹配 <opakowanie> 等嵌套元素的关键。
完成 package-info.java 后，重构 Java 类如下：
1. 根容器类 ProduktyLecznicze（仅保留 @XmlRootElement）：
@XmlAccessorType(XmlAccessType.FIELD)
@XmlRootElement // 不再指定 name 和 namespace，由 package-info 统一管理
public class ProduktyLecznicze {
@XmlAttribute(name = "stanNaDzien")
private String stanNaDzien;
@XmlElement(name = "produktLeczniczy") // 名称匹配 XML，命名空间自动继承
private List<ProduktLeczniczy> produktyLecznicze;
// getter/setter...
}2. 一级子元素 ProduktLeczniczy（移除 @XmlRootElement）：
@XmlAccessorType(XmlAccessType.FIELD)
public class ProduktLeczniczy { // ❌ 删除 @XmlRootElement
@XmlAttribute(name = "nazwaProduktu") private String nazwaProduktu;
@XmlAttribute(name = "id") private int id;
// 关键：添加对嵌套集合的映射（示例：opakowania）
@XmlElement(name = "opakowania")
private Opakowania opakowania; // 或直接定义 List<Opakowanie>（见下文）
// getter/setter...
}3. 补全嵌套结构类（否则 opakowania 等仍为 null）：
仅声明 @XmlElement 不够，还需定义对应 Java 类。例如：
@XmlAccessorType(XmlAccessType.FIELD)
public class Opakowania {
@XmlElement(name = "opakowanie")
private List<Opakowanie> opakowania;
// getter/setter...
}
@XmlAccessorType(XmlAccessType.FIELD)
public class Opakowanie {
@XmlAttribute(name = "wielkosc") private String wielkosc;
@XmlAttribute(name = "kodEAN") private String kodEAN;
@XmlAttribute(name = "id") private String id;
// 其他属性...
}? 替代方案：若希望直接在 ProduktLeczniczy 中持有 List<Opakowanie>，可使用 @XmlElementWrapper + @XmlElement：
@XmlElementWrapper(name = "opakowania") @XmlElement(name = "opakowanie") private List<Opakowanie> opakowania;
最后，解组代码保持简洁：
JAXBContext context = JAXBContext.newInstance(ProduktyLecznicze.class); Unmarshaller unmarshaller = context.createUnmarshaller(); ProduktyLecznicze result = (ProduktyLecznicze) unmarshaller.unmarshal(xmlFile); // 此时 produktyLecznicze 和深层嵌套列表均不再为 null
? 总结关键点：
- 命名空间必须全局、统一声明，package-info.java 是 JAXB 最佳实践；
- @XmlRootElement 仅用于实际 XML 根元素，子类严禁添加；
- 每一层嵌套 XML 元素都需有对应的 Java 类及正确的 @XmlElement / @XmlElementWrapper 映射；
- 使用 XmlAccessType.FIELD 时，确保字段名与 XML 结构语义一致，避免因大小写或命名差异导致绑定失败。
遵循上述结构，JAXB 将准确解析含命名空间的多层嵌套列表，彻底解决 null 返回问题。
