Java11 Spring Boot中Jaxb2插件生成基类失败问题排查

问题根源分析 #

从提供的XSD代码和报错信息来看，有两个核心问题导致解析失败：

1. 全局元素重复定义：XML Schema规范要求同一目标命名空间下不能存在同名的全局<xs:element>，你重复定义了<xs:element name="cufdRequest">，这本身就是语法错误，之前未引用复杂类型时可能未触发严格校验，添加tns引用后解析器严格检查暴露了该问题。
2. 命名空间未正确声明：XSD中使用了tns:cufdCode类型引用，但未在根元素<xs:schema>中声明tns对应的命名空间前缀及目标命名空间，导致解析器无法识别tns指向的类型。

修复步骤 #

1. 修正XSD的命名空间声明 #

在XSD的根元素<xs:schema>中添加命名空间配置，示例如下：

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
           xmlns:tns="http://your-custom-namespace.com"
           targetNamespace="http://your-custom-namespace.com"
           elementFormDefault="qualified">

    <!-- 原XSD内容放在这里 -->
</xs:schema>

• xmlns:tns：声明tns前缀对应的命名空间URI，可自定义（通常是项目相关的唯一URI）
• targetNamespace：指定当前XSD的目标命名空间，需与tns的URI一致
• elementFormDefault="qualified"：确保所有元素都使用目标命名空间

2. 移除重复的全局元素定义 #

删除其中一个<xs:element name="cufdRequest">，或者如果需要支持两种结构，可通过<xs:choice>将结构合并到同一个元素中，示例如下：

<xs:element name="cufdRequest">
    <xs:complexType>
        <xs:choice>
            <!-- 第一种结构 -->
            <xs:sequence>
                <xs:element name="codeBehaviour" type="xs:int" />
                <xs:element name="codeSystem" type="xs:string" />
                <xs:element name="codeMode" type="xs:int" />
                <xs:element name="codePlace" type="xs:int" />
                <xs:element name="codePos" type="xs:int" />
            </xs:sequence>
            <!-- 第二种结构 -->
            <xs:sequence>
                <xs:element name="cufdCode" type="tns:cufdCode" />              
            </xs:sequence>
        </xs:choice>
    </xs:complexType>
</xs:element>

<xs:complexType name="cufdCode">            
    <xs:sequence>
        <xs:element name="code" type="xs:string" />                         
    </xs:sequence>
</xs:complexType>

3. 验证插件配置（可选） #

你的maven-jaxb2-plugin配置本身没有明显问题，确保：

• schemaDirectory指向的路径正确包含所有需要解析的XSD文件
• 若有多个XSD文件，确保它们的命名空间引用关系正确

完成以上修改后，重新执行mvn clean generate-sources命令，即可正常生成对应的Java类。

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