如何优雅地为JAXB从XSD生成类的getter添加@Nullable注解

方案1：使用XJC Annotate插件（推荐，无需自定义开发） #

这是JAXB生态下的最优实现方案，在代码生成阶段自动注入注解，不需要后续手动修改生成的源码。

• 第一步：引入插件和依赖
  如果是Gradle项目，在build.gradle.kts中添加对应依赖：

dependencies {
    // XJC 注解生成插件
    xjc "org.jvnet.jaxb2_commons:jaxb2-basics-annotate:1.1.0"
    // 引入Nullable注解依赖，按需选择对应包名的版本
    implementation "org.jetbrains:annotations:24.0.1"
}

• 第二步：配置全局绑定规则
  在src/main/resources下创建binding.xjb绑定文件，全局匹配所有可空字段，统一给对应getter方法加注解：

<jaxb:bindings version="3.0" xmlns:jaxb="https://jakarta.ee/xml/ns/jaxb"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:annox="http://annox.dev.java.net"
               jaxb:extensionBindingPrefixes="annox">

    <!-- 匹配所有minOccurs=0或者nillable=true的可空字段 -->
    <jaxb:bindings multiple="true" node="//xsd:complexType//xsd:element[@minOccurs='0' or @nillable='true']">
        <annox:annotate target="getter">
            <annox:annotation class="org.jetbrains.annotations.Nullable"/>
        </annox:annotate>
    </jaxb:bindings>

</jaxb:bindings>

• 第三步：执行JAXB生成代码任务，所有可空字段的getter方法会自动带上@Nullable注解，IDEA可以直接识别对应可空性。

方案2：自定义XJC代码生成扩展（无第三方插件依赖） #

如果不想引入第三方插件，可以自行扩展XJC的代码生成逻辑实现需求：

• 继承com.sun.tools.xjc.Plugin类，重写run方法
• 遍历所有生成类的字段，判断字段对应XSD节点的minOccurs、nillable属性，符合可空条件的给对应的getter方法添加注解声明
• 将自定义插件打包后加入xjc的类路径，生成时启用插件即可

注意事项 #

• 优先选择org.jetbrains.annotations.Nullable注解，IDEA原生对该注解的可空性识别准确率最高，不会出现平台类型误判
• 如果使用Jakarta EE版本的JAXB，需要对应调整绑定文件的命名空间和注解插件版本
• 生成代码的模块必须引入对应Nullable注解的依赖，否则会出现编译错误
• Kotlin侧调用生成的Java代码时，会自动识别@Nullable注解标记的方法返回值为可空类型，彻底避免平台类型导致的隐性空指针问题

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