使用JAXB反序列化XML时遭遇UnmarshalException异常求助

环境信息 #

• 设备：Macbook M1
• IDE：Intellij Idea Ultimate
• JDK：OpenJDK 19

问题描述 #

基于XSD生成Java对象后，使用JAXB读取XML文件时抛出UnmarshalException，提示遇到意外元素{my.namespace/Invoices}invoice-list，预期元素为空。尝试过同类问题的常规解决方案，但未解决问题。

相关代码 #

public Aufgabe4(String path) throws JAXBException {
        File f = new File(path);
        JAXBContext context = JAXBContext.newInstance("generated");
        Unmarshaller unmarshaller = context.createUnmarshaller();
        InvoiceList invoiceList = (InvoiceList) JAXBIntrospector.getValue(
                unmarshaller.unmarshal(f));
}

异常堆栈 #

Exception in thread "main" jakarta.xml.bind.UnmarshalException: 
unexpected element (URI:"my.namespace/Invoices", lokal:"invoice-list"). Expected elements are (none)
    at org.glassfish.jaxb.runtime.v2.runtime.unmarshaller.UnmarshallingContext.handleEvent(UnmarshallingContext.java:693)
    at org.glassfish.jaxb.runtime.v2.runtime.unmarshaller.Loader.reportError(Loader.java:230)
    at org.glassfish.jaxb.runtime.v2.runtime.unmarshaller.Loader.reportError(Loader.java:225)
    at org.glassfish.jaxb.runtime.v2.runtime.unmarshaller.Loader.reportUnexpectedChildElement(Loader.java:92)
    at org.glassfish.jaxb.runtime.v2.runtime.unmarshaller.UnmarshallingContext$DefaultRootLoader.childElement(UnmarshallingContext.java:1098)
    at org.glassfish.jaxb.runtime.v2.runtime.unmarshaller.UnmarshallingContext._startElement(UnmarshallingContext.java:527)
    at org.glassfish.jaxb.runtime.v2.runtime.unmarshaller.UnmarshallingContext.startElement(UnmarshallingContext.java:509)
    at org.glassfish.jaxb.runtime.v2.runtime.unmarshaller.SAXConnector.startElement(SAXConnector.java:137)
    at java.xml/com.sun.org.apache.xerces.internal.parsers.AbstractSAXParser.startElement(AbstractSAXParser.java:518)
    at java.xml/com.sun.org.apache.xerces.internal.impl.XMLNSDocumentScannerImpl.scanStartElement(XMLNSDocumentScannerImpl.java:374)
    at java.xml/com.sun.org.apache.xerces.internal.impl.XMLNSDocumentScannerImpl$NSContentDriver.scanRootElementHook(XMLNSDocumentScannerImpl.java:613)
    at java.xml/com.sun.org.apache.xerces.internal.impl.XMLDocumentFragmentScannerImpl$FragmentContentDriver.next(XMLDocumentFragmentScannerImpl.java:3079)
    at java.xml/com.sun.org.apache.xerces.internal.impl.XMLDocumentScannerImpl$PrologDriver.next(XMLDocumentScannerImpl.java:836)
    at java.xml/com.sun.org.apache.xerces.internal.impl.XMLDocumentScannerImpl.next(XMLDocumentScannerImpl.java:605)
    at java.xml/com.sun.org.apache.xerces.internal.impl.XMLNSDocumentScannerImpl.next(XMLNSDocumentScannerImpl.java:112)
    at java.xml/com.sun.org.apache.xerces.internal.impl.XMLDocumentFragmentScannerImpl.scanDocument(XMLDocumentFragmentScannerImpl.java:542)
    at java.xml/com.sun.org.apache.xerces.internal.parsers.XML11Configuration.parse(XML11Configuration.java:889)
    at java.xml/com.sun.org.apache.xerces.internal.parsers.XML11Configuration.parse(XML11Configuration.java:825)
    at java.xml/com.sun.org.apache.xerces.internal.parsers.XMLParser.parse(XMLParser.java:141)
    at java.xml/com.sun.org.apache.xerces.internal.parsers.AbstractSAXParser.parse(AbstractSAXParser.java:1224)
    at java.xml/com.sun.org.apache.xerces.internal.jaxp.SAXParserImpl$JAXPSAXParser.parse(SAXParserImpl.java:637)
    at org.glassfish.jaxb.runtime.v2.runtime.unmarshaller.UnmarshallerImpl.unmarshal0(UnmarshallerImpl.java:218)
    at org.glassfish.jaxb.runtime.v2.runtime.unmarshaller.UnmarshallerImpl.unmarshal(UnmarshallerImpl.java:189)
    at jakarta.xml.bind.helpers.AbstractUnmarshallerImpl.unmarshal(AbstractUnmarshallerImpl.java:146)
    at jakarta.xml.bind.helpers.AbstractUnmarshallerImpl.unmarshal(AbstractUnmarshallerImpl.java:188)
    at jakarta.xml.bind.helpers.AbstractUnmarshallerImpl.unmarshal(AbstractUnmarshallerImpl.java:172)
    at Aufgabe4.<init>(Aufgabe4.java:23)
    at Aufgabe4.main(Aufgabe4.java:15)

Process finished with exit code 1

XSD核心定义 #

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
           targetNamespace="my.namespace/Invoices"
           xmlns="my.namespace/Invoices"
           elementFormDefault="qualified">

    <xs:element name="invoice-list">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="invoice" type="InvoiceType" maxOccurs="unbounded"/>
            </xs:sequence>
        </xs:complexType>
    </xs:element>

    <xs:complexType name="InvoiceType">
        <!-- 内部字段定义省略 -->
    </xs:complexType>
</xs:schema>

XML核心内容 #

<?xml version="1.0" encoding="UTF-8"?>
<invoice-list xmlns="my.namespace/Invoices">
    <invoice>
        <!-- 内部内容省略 -->
    </invoice>
</invoice-list>

解决方案 #

这个错误的核心是JAXBContext未正确关联XML命名空间与生成的Java类，导致解析时无法识别预期元素。可从以下方向修复：

1. 检查package-info.java的正确性 #

生成的generated包下必须存在package-info.java，且命名空间映射与XSD一致：

@XmlSchema(
    namespace = "my.namespace/Invoices",
    elementFormDefault = XmlNsForm.QUALIFIED
)
package generated;

import jakarta.xml.bind.annotation.XmlNsForm;
import jakarta.xml.bind.annotation.XmlSchema;

若文件缺失或命名空间错误，JAXB无法匹配XML元素与对应类。

2. 直接指定根元素类创建JAXBContext #

避免使用包名初始化JAXBContext，直接传入根元素对应的Java类：

JAXBContext context = JAXBContext.newInstance(InvoiceList.class);

这种方式跳过包扫描，直接关联目标类，避免命名空间匹配问题。

3. 验证XJC生成参数 #

生成Java类时，确保XJC工具（或IDE生成配置）正确处理命名空间：

• 命令行生成需指定-p generated包名，无忽略命名空间的参数
• IDE生成需确认配置中启用了命名空间支持

4. 核对XML与XSD的命名空间一致性 #

确保XML根元素的xmlns属性值与XSD的targetNamespace完全一致，包括大小写、斜杠等细节，无任何差异。

5. 检查JAXB依赖版本 #

OpenJDK 19使用Jakarta EE版本的JAXB（jakarta.xml.bind包），需确保项目依赖的JAXB实现（如Glassfish JAXB）版本与JDK兼容，避免版本冲突。

内容的提问来源于stack exchange，提问作者Flori