使用jaxb-maven-plugin将XSD转换为Java时，如何处理根元素与子元素同名的情况？

嘿，这个问题我太熟了！之前帮好几个同事排查过类似的坑——就是你贴的这种XSD结构，根元素是address，结果内部<xs:choice>里还藏了个同名的address子元素，用jaxb-maven-plugin默认生成的话，要么类名冲突，要么反序列化的时候根本分不清哪个是哪个，别慌，咱们用这几个方法搞定它：

1. 用JAXB绑定文件重命名内部元素的生成类 #

这是最通用的解决方案，不管你的XSD是自己写的还是外部给的都能用。你只需要写一个binding.xml自定义绑定规则，给内部的同名元素指定一个新的Java类名，避免和根元素的类重复。

先写绑定文件的内容：

<jaxb:bindings version="2.0" xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
               xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <!-- 关联到你的目标XSD文件，路径根据自己的项目结构调整 -->
    <jaxb:bindings schemaLocation="src/main/resources/xsd/address.xsd">
        <!-- 精准定位到内部的那个address子元素 -->
        <jaxb:bindings node="//xs:element[@name='address']/xs:complexType/xs:choice/xs:element[@name='address']">
            <!-- 把它的生成类命名为InnerAddress，你也可以换成别的名字，比如SubAddress -->
            <jaxb:class name="InnerAddress"/>
        </jaxb:bindings>
    </jaxb:bindings>
</jaxb:bindings>

然后在pom.xml里的jaxb-maven-plugin配置中引入这个绑定文件：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>jaxb2-maven-plugin</artifactId>
    <version>2.5.0</version> <!-- 建议用2.5.0及以上版本，兼容性更好 -->
    <executions>
        <execution>
            <goals>
                <goal>xjc</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <schemaDirectory>${project.basedir}/src/main/resources/xsd</schemaDirectory>
        <!-- 指定绑定文件所在的目录和文件名 -->
        <bindingDirectory>${project.basedir}/src/main/resources/bindings</bindingDirectory>
        <bindingFiles>binding.xml</bindingFiles>
    </configuration>
</plugin>

这样生成后，根元素对应的类还是Address，内部的同名元素会变成InnerAddress，彻底解决命名冲突，序列化反序列化也不会搞混。

2. 给内部元素单独加根元素注解（如果需要） #

要是你还需要把内部的address元素单独拿出来作为根元素序列化/反序列化，那就在绑定规则里再加一行<jaxb:rootElement>配置：

<jaxb:bindings node="//xs:element[@name='address']/xs:complexType/xs:choice/xs:element[@name='address']">
    <jaxb:class name="InnerAddress"/>
    <jaxb:rootElement name="address"/>
</jaxb:bindings>

生成的InnerAddress类上会自动加上@XmlRootElement(name = "address")，既解决了类名冲突，又不影响它作为独立根元素使用，一举两得。

3. 可选：优化XSD设计（如果能改的话） #

要是你的XSD还在设计阶段，没定稿的话，其实可以给内部的address换个更清晰的名字，比如physicalAddress或者residentialAddress，从根源上避免同名问题。不过要是XSD是外部提供的没法修改，那前面的绑定方法绝对是最优解。

内容来源于stack exchange