无法在WebLogic部署Jersey REST，求专属配置及错误解决方法

我之前在WebLogic上部署Jersey 1.x REST服务时也碰到过完全一样的问题，这个错误本质上是WebLogic的类加载机制和Jersey的资源扫描逻辑冲突导致的，下面给你拆解WebLogic的专属配置要点和具体解决步骤：

一、WebLogic的REST服务专属配置要点 #

WebLogic自带了JAX-RS的实现（基于Jersey早期版本），这会和你自己打包的Jersey库产生冲突，同时它的类加载优先级会影响资源类的扫描，所以需要针对性调整以下配置：

1. 强制优先加载应用内的类 #

在WEB-INF目录下创建或修改weblogic.xml，添加类加载优先级配置：

<weblogic-web-app>
  <container-descriptor>
    <!-- 让WEB-INF/lib中的类优先于WebLogic自带类加载 -->
    <prefer-web-inf-classes>true</prefer-web-inf-classes>
    <!-- 禁用WebLogic自带的Jersey自动支持 -->
    <disable-implicit-jersey-support>true</disable-implicit-jersey-support>
  </container-descriptor>
</weblogic-web-app>

这是解决WebLogic和Jersey冲突最关键的一步，能避免WebLogic用自带的Jersey版本覆盖你应用的依赖

2. 禁用WebLogic的自动JAX-RS扫描 #

如果你的应用中使用了@ApplicationPath注解的类，WebLogic会自动扫描并启用自带的JAX-RS支持，这会和你配置的RestServlet冲突，上面的disable-implicit-jersey-support配置就是用来关闭这个自动扫描的。

二、具体解决部署失败的步骤 #

结合报错信息ResourceConfig实例未包含任何根资源类，还要检查以下内容：

• 确认RestServlet的资源包配置正确
  在web.xml中检查RestServlet的初始化参数，确保包路径是你存放带有@Path注解的资源类的包：

  <servlet>
    <servlet-name>RestServlet</servlet-name>
    <servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer</servlet-class>
    <init-param>
      <param-name>com.sun.jersey.config.property.packages</param-name>
      <!-- 替换成你的资源类所在包，多个包用逗号分隔 -->
      <param-value>com.yourcompany.gateway.resources</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>RestServlet</servlet-name>
    <url-pattern>/rest/*</url-pattern>
  </servlet-mapping>
  

  如果包扫描还是失效，可以尝试直接指定资源类的全限定名，跳过扫描步骤：

  <init-param>
    <param-name>com.sun.jersey.config.property.classnames</param-name>
    <param-value>com.yourcompany.gateway.resources.UserResource,com.yourcompany.gateway.resources.OrderResource</param-value>
  </init-param>
  

• 检查Jersey依赖完整性
  确保你的WAR包的WEB-INF/lib目录下包含Jersey 1.2的核心依赖：

  • jersey-core-1.2.jar
  • jersey-server-1.2.jar
  • jersey-servlet-1.2.jar
  • jsr311-api-1.1.1.jar
    不要遗漏这些依赖，也不要混入其他版本的Jersey或JAX-RS jar包，避免版本冲突

• 验证资源类的注解正确性
  确认你的资源类正确使用了@Path注解，并且类是public的，比如：

  package com.yourcompany.gateway.resources;
  
  import javax.ws.rs.GET;
  import javax.ws.rs.Path;
  import javax.ws.rs.Produces;
  
  @Path("/users")
  public class UserResource {
      @GET
      @Produces("application/json")
      public String getUsers() {
          return "[{\"id\":1,\"name\":\"test\"}]";
      }
  }
  

三、验证解决方案 #

按照上面的配置调整后，重新打包部署到WebLogic：

1. 启动WebLogic服务器，查看日志是否还有<BEA-101216>错误
2. 访问你的REST接口，比如http://your-weblogic-host:port/gateway/rest/users，确认能正常返回数据

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