WebSphere中JAX-RS整合Swagger遇InvocationTargetException求助

问题重现 #

部署基于WebSphere的JAX-RS应用时，AppConfig类构造函数中BeanConfig beanConfig = new BeanConfig();行触发异常，错误信息：

Resource class main.AppConfig can not be instantiated due to InvocationTargetException

其中InvocationTargetException的目标为null。

相关配置与代码 #

web.xml配置 #

<servlet>
    <servlet-name>TestServlet</servlet-name>
    <servlet-class>com.ibm.websphere.jaxrs.server.IBMRestServlet</servlet-class>
    <init-param>
        <param-name>javax.ws.rs.Application</param-name>
        <param-value>main.AppConfig</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>TestServlet</servlet-name>
    <url-pattern>/*</url-pattern>
</servlet-mapping>

AppConfig类代码 #

public AppConfig() {
    BeanConfig beanConfig = new BeanConfig();
    beanConfig.setVersion("1.0.0");
    beanConfig.setSchemes(new String[]{"http"});
    beanConfig.setHost("localhost:9080");
    beanConfig.setBasePath("/");
    beanConfig.setResourcePackage("io.swagger.resources");
    beanConfig.setScan(true);
}
@Override
public Set<Class<?>> getClasses() {
    Set<Class<?>> classes = new HashSet<Class<?>>();
    classes.add(Test.class);
    
    classes.add(io.swagger.jaxrs.listing.ApiListingResource.class);
    classes.add(io.swagger.jaxrs.listing.SwaggerSerializers.class);
    return classes;
}

排查与解决方案 #

1. 捕获根异常，定位真实错误 #

InvocationTargetException是包装异常，真实错误被隐藏。在构造函数中添加异常捕获，打印完整栈轨迹：

public AppConfig() {
    try {
        BeanConfig beanConfig = new BeanConfig();
        beanConfig.setVersion("1.0.0");
        beanConfig.setSchemes(new String[]{"http"});
        beanConfig.setHost("localhost:9080");
        beanConfig.setBasePath("/");
        beanConfig.setResourcePackage("io.swagger.resources");
        beanConfig.setScan(true);
    } catch (Exception e) {
        e.printStackTrace();
        throw new RuntimeException("Failed to initialize BeanConfig", e);
    }
}

查看日志中的根异常，比如类找不到、依赖缺失等具体问题。

2. 检查Swagger依赖完整性与版本兼容性 #

• 确保项目已引入正确的Swagger依赖（针对JAX-RS），Maven示例：

  <!-- 版本需与WebSphere JAX-RS版本匹配，WebSphere通常自带JAX-RS 1.x，对应Swagger 1.x系列 -->
  <dependency>
      <groupId>io.swagger</groupId>
      <artifactId>swagger-jaxrs</artifactId>
      <version>1.6.2</version>
  </dependency>
  <dependency>
      <groupId>io.swagger</groupId>
      <artifactId>swagger-core</artifactId>
      <version>1.6.2</version>
  </dependency>
  

• 调整WebSphere应用类加载策略为PARENT_LAST，避免容器自带的旧版本类覆盖项目依赖。
• 若使用WebSphere 8.5.5+，可启用JAX-RS 2.x特性，对应使用Swagger 2.x版本。

3. 修正ResourcePackage配置 #

beanConfig.setResourcePackage("io.swagger.resources");设置的包路径错误，实际资源类Test不在该包下，应改为Test所在的包（比如main或具体包名）：

beanConfig.setResourcePackage("main"); // 假设Test类在main包下

4. 调整BeanConfig初始化时机 #

避免在构造函数中初始化BeanConfig，改用@PostConstruct注解（需确保AppConfig继承Application类并被JAX-RS容器托管），或者在getClasses方法中初始化：

方式1：使用@PostConstruct

import javax.annotation.PostConstruct;
import javax.ws.rs.core.Application;

public class AppConfig extends Application {
    @PostConstruct
    public void initSwagger() {
        BeanConfig beanConfig = new BeanConfig();
        beanConfig.setVersion("1.0.0");
        beanConfig.setSchemes(new String[]{"http"});
        beanConfig.setHost("localhost:9080");
        beanConfig.setBasePath("/");
        beanConfig.setResourcePackage("main");
        beanConfig.setScan(true);
    }

    @Override
    public Set<Class<?>> getClasses() {
        Set<Class<?>> classes = new HashSet<Class<?>>();
        classes.add(Test.class);
        classes.add(io.swagger.jaxrs.listing.ApiListingResource.class);
        classes.add(io.swagger.jaxrs.listing.SwaggerSerializers.class);
        return classes;
    }
}

方式2：在getClasses中初始化

@Override
public Set<Class<?>> getClasses() {
    // 初始化BeanConfig
    BeanConfig beanConfig = new BeanConfig();
    beanConfig.setVersion("1.0.0");
    beanConfig.setSchemes(new String[]{"http"});
    beanConfig.setHost("localhost:9080");
    beanConfig.setBasePath("/");
    beanConfig.setResourcePackage("main");
    beanConfig.setScan(true);

    Set<Class<?>> classes = new HashSet<Class<?>>();
    classes.add(Test.class);
    classes.add(io.swagger.jaxrs.listing.ApiListingResource.class);
    classes.add(io.swagger.jaxrs.listing.SwaggerSerializers.class);
    return classes;
}

// 移除构造函数中的BeanConfig初始化代码

5. 验证WebSphere JAX-RS特性启用 #

1. 登录WebSphere控制台，进入应用程序 > 应用程序类型 > WebSphere企业应用程序
2. 选中目标应用，点击管理模块
3. 检查模块的JAX-RS特性是否启用，若未启用则勾选并保存配置。

内容的提问来源于stack exchange，提问作者Emre Özincegedik