WebSphere Liberty中EclipseLink与JPA3.0兼容及类转换异常问题

问题根源 #

你遇到的ClassCastException是因为应用自行引入的EclipseLink类与Liberty容器内置的EclipseLink类被不同类加载器加载，导致HistoryCustomizer无法转换为容器类加载器提供的DescriptorCustomizer类型。Liberty的persistence-3.0特性本身集成了特定版本的EclipseLink实现，无需重复打包该依赖。

正确配置步骤 #

1. 调整Liberty特性配置 #

在server.xml中同时启用JPA 3.0 API和EclipseLink 3.0实现特性：

<featureManager>
    <feature>persistence-3.0</feature>
    <feature>eclipselink-3.0</feature>
</featureManager>

2. 修正Maven依赖坐标 #

使用与Liberty 23.0.0.11内置版本匹配的EclipseLink依赖，并设置为provided scope，避免应用重复打包类库：

<dependencies>
    <!-- EclipseLink核心依赖，由Liberty容器提供 -->
    <dependency>
        <groupId>org.eclipse.persistence</groupId>
        <artifactId>org.eclipse.persistence.core</artifactId>
        <version>3.0.4</version>
        <scope>provided</scope>
    </dependency>
    <!-- JPA API实现，由Liberty容器提供 -->
    <dependency>
        <groupId>org.eclipse.persistence</groupId>
        <artifactId>org.eclipse.persistence.jpa</artifactId>
        <version>3.0.4</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

3. 类加载一致性验证 #

设置provided scope后，应用将直接使用Liberty容器内置的EclipseLink类，自定义的HistoryCustomizer与DescriptorCustomizer将处于同一类加载上下文，彻底解决类型转换异常。

版本匹配说明 #

WebSphere Liberty 23.0.0.11的eclipselink-3.0特性内置的正是EclipseLink 3.0.4版本，与JPA 3.0规范完全兼容，无需额外调整版本号。

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