迁移至Liberty后自定义JAXB NamespacePrefixMapper无法正常工作求助

问题概述 #

从WAS迁移至Liberty后，应用中自定义的MyNamespaceMapper（继承自com.sun.xml.bind.marshaller.NamespacePrefixMapper）设置到Marshaller属性时，出现类型不匹配错误：提示命名空间映射器必须是Liberty自带的com.sun.xml.bind.marshaller.NamespacePrefixMapper实例，而非应用自定义类实例。核心原因是Liberty自带的JAXB类和应用打包的jaxb-impl类由不同类加载器加载，导致类实例无法互认。

解决方案 #

1. 调整应用类加载器配置（优先尝试） #

在Liberty的server.xml中为应用配置类加载策略，让应用优先使用Liberty内置的JAXB类，避免类加载冲突：

<application id="your-app" name="your-app" location="your-app.war" type="war">
    <classloader delegation="parentFirst">
        <package type="api" name="com.sun.xml.bind.marshaller"/>
        <!-- 可按需添加其他JAXB相关包，如com.sun.xml.bind.* -->
    </classloader>
</application>

• delegation="parentFirst"：指定应用优先使用Liberty父类加载器中的类，确保自定义映射器和Liberty使用的是同一个NamespacePrefixMapper类实例
• <package type="api" ...>：明确将com.sun.xml.bind.marshaller包标记为API，允许应用访问Liberty内置的该类

2. 修复自定义Liberty用户特性配置 #

如果之前尝试的用户特性未生效，调整特性和bundle的清单文件：

修改Feature-marshaller.MF

确保特性的依赖和API暴露配置正确：

Subsystem-ManifestVersion: 1.0
Subsystem-SymbolicName: com.example.marshaller.feature; visibility:=public
Subsystem-Version: 1.0.0
Subsystem-Type: osgi.subsystem.feature
Subsystem-Content: com.example.marshaller.bundle; version="[1.0.0,1.0.0]"
IBM-Feature-Version: 2
IBM-API-Package: com.sun.xml.bind.marshaller; type="api"
IBM-ShortName: marshaller-feature

修改MANIFEST.MF

不要重复打包JAXB类，改为依赖Liberty内置的JAXB API：

Manifest-Version: 1.0
Bundle-ManifestVersion: 2
Bundle-Name: Marshaller Bundle
Bundle-SymbolicName: com.example.marshaller.bundle
Bundle-Version: 1.0.0
Import-Package: com.sun.xml.bind.marshaller,
                org.osgi.framework
Bundle-RequiredExecutionEnvironment: JavaSE-1.8
Export-Package: com.yourpackage.mappers; version="1.0.0"

• 移除Bundle-ClassPath: jaxb-impl-1.0.0.jar，避免打包与Liberty内置重复的JAXB类
• Export-Package改为导出你自己的MyNamespaceMapper所在的包，而非JAXB的API包

配置完成后，将特性文件放入Liberty的usr/extension/lib/features目录，bundle放入usr/extension/lib，并在server.xml中启用特性：

<featureManager>
    <feature>com.example.marshaller.feature-1.0.0</feature>
</featureManager>

3. 替代方案：对齐JAXB依赖版本（推荐） #

确保应用引入的JAXB依赖与Liberty内置版本一致，避免版本和类加载冲突：
如果使用Maven，将jaxb-impl依赖设置为provided scope：

<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-impl</artifactId>
    <version>2.2.11</version> <!-- 与Liberty内置JAXB版本匹配 -->
    <scope>provided</scope>
</dependency>

这样应用会直接使用Liberty内置的JAXB类，自定义映射器就能正常被识别。

关键注意点 #

• 禁止应用打包Liberty已经内置的JAXB类，否则必然触发类加载冲突
• JAXB属于系统级API，类加载器建议使用parentFirst策略

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