JAXB/MOXY配置XmlAdapter报类名或类加载器错误如何解决

错误诱因及解决方案 #

核心诱因1：绑定文件配置不完整 #

你当前的绑定文件只写了适配器的短类名，没有声明适配的包路径，MOXY加载时无法定位到tufts.sds包下的MarshallingPointAdapter类，这是你哪怕换官方示例适配器也报错的最常见原因。

核心诱因2：依赖版本不兼容 #

你混用Jakarta/Java EE包和MOXY版本也会触发该错误：

• MOXY 2.x版本仅支持javax.xml.bind包下的API
• MOXY 3.0+版本才支持jakarta.xml.bind包下的API
  如果你的MOXY版本和导入的XmlAdapter包不匹配，哪怕类名配置正确也会加载失败。

核心诱因3：模块化环境类隔离 #

如果你的项目运行在Java 9+模块化环境、OSGi、Spring Boot等类加载隔离的环境中，MOXY的类加载器没有权限访问你自定义的适配器类，也会抛出该错误。 #

具体修复步骤 #

1. 修正绑定文件配置
   在绑定文件的根标签中添加package="tufts.sds"属性，同时补全适配器的全限定类名，完整配置示例如下：

<xml-bindings
    xmlns="http://www.eclipse.org/eclipselink/xsds/persistence/oxm"
    version="2.4"
    package="tufts.sds">
    <xml-java-type-adapters>
        <xml-java-type-adapter value="tufts.sds.MarshallingPointAdapter" type="java.awt.geom.Point2D"/>
    </xml-java-type-adapters>
</xml-bindings>

2. 对齐依赖版本

• 若使用jakarta.xml.bind：升级MOXY到3.0+版本，同步使用3.0+版本的Jakarta XML Bind API
• 若使用javax.xml.bind：使用2.x版本的MOXY，同步使用2.3.x版本的JAXB API，避免两个包同时出现在依赖中

3. 解决类加载隔离问题
   如果是Java 9+模块化项目，在module-info.java中添加以下配置开放包访问权限：

opens tufts.sds to org.eclipse.persistence.moxy, jakarta.xml.bind;

如果是javax版本的API，把上面的jakarta.xml.bind替换为javax.xml.bind即可。 #

内容的提问来源于stack exchange，提问作者C Stuart Hardwick