从JAXB XJC代码生成迁移到Jakarta与Java 17的类名差异问题咨询

问题原因 #

你遇到的类名生成不一致问题不属于预期的版本行为差异，也不是旧版JAXB的解析错误，核心原因是Jakarta 3.0+对应的JAXB 3.x版本调整了绑定规则的命名空间：

• 旧版JAXB 2.x使用的绑定命名空间是 http://java.sun.com/xml/ns/jaxb，你当前xsd文件里的<jxb:class>注解用的就是这个旧命名空间
• 新版Jakarta JAXB 3.x的绑定命名空间已切换为 https://jakarta.ee/xml/ns/jaxb，旧命名空间的自定义绑定规则会被直接忽略，所以xjc会回退到默认逻辑，直接用<xsd:complexType>的name属性值ForkStepType生成类名

解决方案 #

你可以任选以下两种方案恢复原有生成逻辑：

1. 修改现有xsd文件的命名空间声明
   找到xsd头部jxb前缀的命名空间定义，替换为新版命名空间，同时将jxb版本声明改为3.0即可，示例修改如下：

   <!-- 旧配置 -->
   xmlns:jxb="http://java.sun.com/xml/ns/jaxb"
   jxb:version="2.0"
   
   <!-- 新配置 -->
   xmlns:jxb="https://jakarta.ee/xml/ns/jaxb"
   jxb:version="3.0"
   

2. 新增独立的外部绑定文件
   如果不想修改原有xsd文件，可以单独编写后缀为.xjb的绑定文件，在文件中声明新版命名空间和自定义类名规则，执行xjc命令时通过-b 绑定文件名.xjb参数指定加载该规则即可。

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