使用JAXB2 Maven Plugin生成XSD时忽略元素名与文件名问题排查

问题原因拆解 #

1. 元素名、命名空间失效

   • package-info.java没配置elementFormDefault = XmlNsForm.QUALIFIED，导致生成的XSD元素不绑定指定命名空间，同时插件读不到全局命名空间配置。
   • @XmlType的propOrder写错了：填的是XML元素名"Entries"，但因为用了@XmlAccessorType(XmlAccessType.FIELD)，这里应该对应Java字段名"entries"，错配会让JAXB忽略字段上的@XmlElement注解。
   • Maven插件的sources没包含package-info.java，插件压根没读取到包级别的命名空间规则。

2. 文件名未重命名+警告
   因为生成的XSD没有正确的targetNamespace（没读到package-info的配置），插件的transformSchema里的uri找不到匹配的命名空间，所以重命名失败，出现SimpleNamespaceResolver contained no localNamespaceURI; aborting rename.警告。

具体修复步骤 #

1. 修正package-info.java #

添加元素命名空间绑定配置，确保所有XML元素都归属指定命名空间：

@XmlSchema(
    namespace = "https://my.test.domain",
    elementFormDefault = XmlNsForm.QUALIFIED
)
package com.my.testpackage;

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

2. 修正TestXmlClass的propOrder #

把propOrder里的值改成Java字段名"entries"，别再写XML元素名：

@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(
    namespace = "https://my.test.domain",
    propOrder = {
        "entries" // 这里对应Java字段名，不是XML元素名
    })
@XmlRootElement(
    namespace = "https://my.test.domain",
    name = "TestXmlClass"
)
public class TestXmlClass {

  @XmlElement(name = "Entries")
  protected List<String> entries;

  // getter、setter代码保持不变
}

3. 更新Maven插件配置 #

把package-info.java加入sources列表，确保插件能读取到包级注解：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>jaxb2-maven-plugin</artifactId>
    <version>3.1.0</version>
    <executions>
        <execution>
            <id>schemagen</id>
            <goals>
                <goal>schemagen</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <sources>
            <source>src/main/java/com/my/testpackage/TestXmlClass.java</source>
            <source>src/main/java/com/my/testpackage/package-info.java</source>
        </sources>
        <transformSchemas>
            <transformSchema>
                <uri>https://my.test.domain</uri>
                <toFile>my-xsd-file.xsd</toFile>
            </transformSchema>
        </transformSchemas>
        <!-- 可选：自定义XSD输出目录，默认是target/generated-resources/schemagen -->
        <outputDirectory>target/generated-resources/xsd</outputDirectory>
    </configuration>
</plugin>

验证修复效果 #

执行mvn clean jaxb2:schemagen后，生成的my-xsd-file.xsd会包含：

• 正确的targetNamespace="https://my.test.domain"
• 元素名显示为"Entries"（匹配@XmlElement注解）
• 根元素TestXmlClass的声明

示例正确输出：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema"
           targetNamespace="https://my.test.domain" xmlns:tns="https://my.test.domain"
           elementFormDefault="qualified">

  <xs:element name="TestXmlClass" type="tns:testXmlClass"/>

  <xs:complexType name="testXmlClass">
    <xs:sequence>
      <xs:element name="Entries" type="xs:string" nillable="true" minOccurs="0" maxOccurs="unbounded"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>

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