使用maven-jaxb2-plugin生成VMAP类失败：无法解析vast:VAST元素

问题核心 #

使用maven-jaxb2-plugin从VMAP XSD生成类时，出现解析错误：

[ERROR] Error while parsing schema(s).Location [ file:/projects/generate-vmap-example/src/main/resources/vmap.xsd{144,70}].
org.xml.sax.SAXParseException: src-resolve: Cannot resolve the name 'vast:VAST' to a(n) 'element declaration' component.

VMAP XSD已声明VAST命名空间并导入对应XSD：

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:vmap="http://www.iab.net/videosuite/vmap" xmlns:vast="http://www.iab.net/videosuite/vast" targetNamespace="http://www.iab.net/videosuite/vmap" attributeFormDefault="unqualified" elementFormDefault="qualified" version="1.0">
    <xs:import namespace="http://www.iab.net/videosuite/vast" schemaLocation="vast3_draft.xsd"/>
</xs:schema>

在VASTAdData_type类型中引用了vast:VAST元素：

<xs:complexType name="VASTAdData_type">
    <xs:sequence>
        <xs:element ref="vast:VAST" minOccurs="1" maxOccurs="1"/>
    </xs:sequence>
</xs:complexType>

为何找不到VAST元素？ #

可能的原因有三个：

• VAST XSD的命名空间不匹配：检查vast3_draft.xsd的targetNamespace是否为http://www.iab.net/videosuite/vast。如果导入的XSD命名空间和VMAP中声明的不一致，解析器无法关联到对应的元素。
• schemaLocation路径错误：确认vast3_draft.xsd的存放位置是否和VMAP XSD中指定的路径一致。比如如果VMAP XSD在src/main/resources下，那么VAST XSD也需要放在同目录，或者使用正确的相对路径，确保maven构建时能正确加载到该文件。
• VAST XSD中无全局VAST元素：查看vast3_draft.xsd是否声明了全局的VAST元素（即直接在<xs:schema>下的<xs:element name="VAST">）。如果VAST是某个复杂类型下的局部元素，或者元素名称拼写错误（比如大小写不一致），也会导致解析器找不到。

是否需要修改VMAP XSD？ #

• 如果是前两种原因（命名空间不匹配、路径错误），不需要修改VMAP XSD，只需调整VAST XSD的命名空间或修正schemaLocation路径即可。
• 如果是第三种原因（VAST元素不是全局或名称不符），则需要修改VMAP XSD的引用方式，或者调整VAST XSD将VAST声明为全局元素。比如如果VAST是局部元素，可能需要改用<xs:element name="VAST" type="vast:VAST_type"/>（假设对应的类型存在），而不是用ref引用。

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