Jersey 2.34环境下Swagger 2.x自定义SpecFilter不执行如何解决

你遇到的两个报错/不生效问题本质是混淆了不同体系的过滤器类型：
io.swagger.v3.core.filter.SpecFilter是Swagger/OpenAPI专用的规范过滤器，既不实现javax.servlet.Filter接口，也不属于Jersey的Provider组件，所以不管是配置到web.xml的<filter>节点还是jersey.config.server.provider.classnames参数中都无法正常工作，前者还会抛出类型转换异常。

针对Jersey 2.34 + Swagger 2.x/OpenAPI 3.0的环境，按以下方式配置即可触发自定义SpecFilter：

方式1：代码配置（推荐，适合有Jersey配置类的场景） #

如果你用Jersey的ResourceConfig类注册服务，直接在配置类中声明Swagger规则并指定过滤器类即可：

import org.glassfish.jersey.server.ResourceConfig;
import io.swagger.v3.jaxrs2.integration.JaxrsOpenApiContextBuilder;
import io.swagger.v3.oas.integration.OpenApiConfigurationException;
import io.swagger.v3.oas.integration.SwaggerConfiguration;
import java.util.Set;

public class JerseyServiceConfig extends ResourceConfig {
    public JerseyServiceConfig() {
        // 注册你的业务REST接口包
        packages("com.your.business.rest");
        // 注册Swagger内置资源
        packages("io.swagger.v3.jaxrs2.integration.resources");

        // 配置OpenAPI规则，指定自定义过滤器
        SwaggerConfiguration oasConfig = new SwaggerConfiguration()
                .resourcePackages(Set.of("com.your.business.rest"))
                // 此处填写你自定义SpecFilter的全类名
                .filterClass("my.package.ApiAuthorizationFilterImpl");

        try {
            new JaxrsOpenApiContextBuilder<>()
                    .application(this)
                    .openApiConfiguration(oasConfig)
                    .buildContext(true);
        } catch (OpenApiConfigurationException e) {
            throw new RuntimeException("Swagger配置初始化失败", e);
        }
    }
}

方式2：web.xml配置（适合纯xml配置的场景） #

如果你的Jersey服务完全通过web.xml配置，直接在Jersey的Servlet配置中新增openApi.configuration.filterClass初始化参数即可：

<servlet>
    <servlet-name>JerseyServlet</servlet-name>
    <servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>
    <init-param>
        <param-name>jersey.config.server.provider.packages</param-name>
        <param-value>com.your.business.rest;io.swagger.v3.jaxrs2.integration.resources</param-value>
    </init-param>
    <!-- 核心配置：指定Swagger自定义过滤器 -->
    <init-param>
        <param-name>openApi.configuration.filterClass</param-name>
        <param-value>my.package.ApiAuthorizationFilterImpl</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>

注意修正过滤器实现 #

你当前贴出的filterOperation方法没有返回值，要调整返回逻辑：保留Operation直接返回对象，需要过滤掉就返回null：

@Override
protected Operation filterOperation(OpenAPISpecFilter filter, Operation operation, String resourcePath, String key, Map<String, List<String>> params, Map<String, String> cookies, Map<String, List<String>> headers) {
    System.out.println("Filtering operations: "+operation.getSummary());
    // 示例逻辑：仅保留摘要包含"公开"的接口
    if (operation.getSummary() != null && operation.getSummary().contains("公开")) {
        return operation;
    }
    // 不符合条件的接口返回null即可从文档中隐藏
    return null;
}

如果上述配置仍不满足需求，可以选择以下两种实现方案：

• 固定隐藏接口：直接在不需要展示的类/方法上添加io.swagger.v3.oas.annotations.Hidden注解，Swagger会自动隐藏对应接口，无需额外编码。
• 动态权限过滤：自定义Jersey的ContainerResponseFilter，拦截/openapi.json请求，拿到返回的OpenAPI对象后根据当前请求权限手动删减内容，适合按用户角色展示不同接口的场景。

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