WAS Liberty Profile迁移应用时遭遇EclipseLink VerifyError问题

这是典型的EclipseLink类加载冲突问题，我之前帮好几个团队解决过WAS传统版到Liberty Profile的类似迁移场景，给你几个明确的解决步骤：

1. 移除应用中打包的EclipseLink依赖 #

首先检查你的WAR/EAR包的WEB-INF/lib（WAR格式）或lib（EAR格式）目录，看看是否包含eclipselink.jar、javax.persistence-api.jar这类EclipseLink相关的JAR文件。如果有，直接删除这些依赖。

原因很简单：WebSphere Liberty本身已经集成了符合JPA规范的EclipseLink版本，你自己打包的2.5.1版本和Liberty自带的版本类结构不一致，导致类加载时出现类型不匹配的校验错误——就是你日志里看到的ConversionManager无法转换为CoreConversionManager的问题。

2. 配置server.xml中的JPA/相关特性 #

在你的server.xml里，确保添加了匹配你应用技术栈版本的特性：

<featureManager>
    <!-- 或者单独指定所需特性，和你的技术栈精准匹配 -->
    <feature>ejb-3.2</feature>
    <feature>jsf-2.2</feature>
    <feature>jpa-2.1</feature>
    <!-- 基础Web特性可选添加 -->
    <feature>webProfile-7.0</feature>
</featureManager>

jpa-2.1对应的正是EclipseLink 2.5.x系列，和你原来使用的版本完全匹配，不需要额外引入外部JAR。

如果必须使用自定义EclipseLink版本（不推荐） #

如果因为某些特殊需求必须用你自己的2.5.1版本，需要配置类加载隔离，让Liberty优先加载你提供的EclipseLink类，而不是自带的：

<application id="your-app" name="your-app" location="your-app.war" type="war">
    <classloader delegation="parentLast">
        <!-- 把你的EclipseLink相关JAR放到服务器的lib/eclipselink目录下 -->
        <privateLibrary id="EclipseLinkLib">
            <fileset dir="${server.config.dir}/lib/eclipselink" includes="*.jar"/>
        </privateLibrary>
    </classloader>
</application>

注意：这种方式可能会引入其他兼容性问题，优先推荐使用Liberty自带的兼容版本。

3. 清理Liberty缓存 #

迁移过程中服务器可能残留旧的类缓存，导致问题反复出现：

• 停止Liberty服务器
• 删除wlp/usr/servers/[你的服务器名称]/workarea和wlp/usr/servers/[你的服务器名称]/cache目录下的所有内容
• 重新启动服务器，部署应用

错误根源再解释 #

你日志里的VerifyError本质是类加载的双亲委派机制冲突：Liberty自带的EclipseLink类和你应用打包的类被同时加载，两个版本中DatasourcePlatform.getConversionManager()的返回类型定义不一致，JVM在校验字节码时发现实际返回的类型和方法签名要求的类型不兼容，所以抛出了这个错误。

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