WebSphere 8部署Jersey 2应用报错：JerseyServletContainerInitializer非子类型

这个报错Provider org.glassfish.jersey.servlet.init.JerseyServletContainerInitializer not a subtype我之前在WebSphere上部署Jersey应用时也碰到过，本质是类加载冲突导致的——WebSphere自带的Servlet API类和你WAR包中引入的（或者Jersey依赖带进来的）Servlet API类被不同的类加载器加载，导致Jersey的初始化器类和WebSphere期望的ServletContainerInitializer不是同一个类型（Java中同一个类被不同类加载器加载会被视为不同的类）。

下面是我亲测有效的解决方案，一步步来：

1. 排除Jersey依赖中的Servlet API #

WebSphere本身已经提供了Servlet 3.0的API，而jersey-container-servlet依赖会间接引入javax.servlet-api，这会导致类冲突。修改你的pom.xml，给Jersey依赖添加排除规则：

<dependency>
    <groupId>org.glassfish.jersey.containers</groupId>
    <artifactId>jersey-container-servlet</artifactId>
    <version>2.21</version>
    <exclusions>
        <exclusion>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

2. 确认类加载配置的细节 #

你已经设置了“本地类加载器优先（父最后）”，但还要检查几个细节：

• 进入WebSphere管理控制台 → 应用程序 → 你的目标应用 → 类加载和更新检测
• 确保类加载顺序选择的是「类加载器的本地类先加载（父最后）」
• 如果你的应用是打包在EAR里，还要确认WAR类加载策略设置为「应用程序类加载器」，让WAR的类优先被加载。

3. 验证禁用IBM JAX-RS引擎的配置 #

你设置的com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine=true这个属性，一定要确保它生效：

• 推荐在应用的定制属性中添加：进入WebSphere管理控制台 → 应用程序 → 你的应用 → 定制属性 → 新建，键填com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine，值填true
• 也可以在服务器的JVM参数中添加-Dcom.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine=true，但这种方式会影响所有部署在该服务器上的应用，按需选择。

4. 清理WebSphere缓存 #

WebSphere的缓存经常会“记住”旧的类文件，导致修改后不生效，这一步很关键：

• 先停止WebSphere服务器
• 删除<WebSphere安装目录>/profiles/<你的概要目录>/temp下的所有文件和文件夹
• 删除<WebSphere安装目录>/profiles/<你的概要目录>/wstemp下的所有内容
• 重新启动服务器，再重新部署你的应用。

5. 额外排查点 #

如果以上步骤都没解决，再检查这两点：

• 打开你的WAR包，确认里面没有自己打包进去的servlet-api.jar或者其他Servlet相关的JAR，如果有，直接删除它们
• 尝试升级Jersey版本到2.30+（比如2.35），旧版本的Jersey（比如2.21）和WebSphere 8的兼容性可能存在一些小问题，升级后大概率能解决。

按照这些步骤操作，应该就能解决启动报错的问题了。

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