Jersey技术问题：如何绕过所有过滤器与资源匹配？

嘿，这个需求我之前在项目里刚好碰到过，咱们来拆解几种可行的方案，包括你提到的思路，再看看更高效的实现方式：

1. 你提出的异常方案：可行但可优化 #

你的思路方向是对的——用最高优先级的pre-matching filter拦截黑名单URL，通过异常映射器返回404。不过这里可以优化：直接返回404响应，不需要抛出异常，因为异常处理会带来额外的栈追踪开销，完全没必要。

如果坚持用异常方案，代码示例如下：

// 自定义黑名单异常类
public class BlackListException extends RuntimeException {}

// 最高优先级的pre-matching filter
@PreMatching
@Priority(Priorities.USER - 100) // Jersey中数值越小优先级越高，确保比其他pre-matching filter先执行
public class BlackListFilter implements ContainerRequestFilter {
    private Set<String> blacklist = Set.of("/forbidden/url1", "/forbidden/url2");

    @Override
    public void filter(ContainerRequestContext requestContext) throws IOException {
        String path = requestContext.getUriInfo().getPath();
        if (blacklist.contains(path)) {
            throw new BlackListException();
        }
    }
}

// 异常映射器，处理黑名单异常返回404
public class BlackListExceptionMapper implements ExceptionMapper<BlackListException> {
    @Override
    public Response toResponse(BlackListException exception) {
        return Response.status(Response.Status.NOT_FOUND).build();
    }
}

最后在ResourceConfig中注册这两个类即可。

2. 更高效的方案：直接在Filter中终止请求 #

其实不用抛异常，直接在pre-matching filter里调用abortWith()就能立刻返回404，终止整个请求链，完全绕过后续的pre-matching filters、post-matching filters和资源处理。这是Jersey内部最直接轻量的方式：

@PreMatching
@Priority(Priorities.USER - 100)
public class BlackListFilter implements ContainerRequestFilter {
    private Set<String> blacklist = Set.of("/forbidden/url1", "/forbidden/url2");

    @Override
    public void filter(ContainerRequestContext requestContext) throws IOException {
        String path = requestContext.getUriInfo().getPath();
        if (blacklist.contains(path)) {
            // 直接返回404，终止请求链
            requestContext.abortWith(Response.status(Response.Status.NOT_FOUND).build());
        }
    }
}

这个方案比抛异常更简洁高效，也是我最推荐的Jersey内部实现方式。

3. 极致性能方案：用Servlet Filter拦截 #

如果想要完全绕过Jersey的所有处理逻辑（包括它的pre-matching filters），可以在Servlet层做拦截。因为Servlet Filter是在Jersey接收请求之前运行的，性能会更优，适合对性能要求极高的场景：

@WebFilter(urlPatterns = "/*")
public class BlackListServletFilter implements Filter {
    private Set<String> blacklist = Set.of("/forbidden/url1", "/forbidden/url2");

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        HttpServletRequest httpRequest = (HttpServletRequest) request;
        String path = httpRequest.getRequestURI();
        
        if (blacklist.contains(path)) {
            HttpServletResponse httpResponse = (HttpServletResponse) response;
            httpResponse.setStatus(HttpServletResponse.SC_NOT_FOUND);
            return; // 不继续执行后续链，直接返回404
        }
        
        chain.doFilter(request, response);
    }

    // init和destroy方法可留空
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {}
    @Override
    public void destroy() {}
}

如果是传统web.xml配置，只需将这个Filter注册并设置最高优先级即可。

方案对比 #

我个人最推荐第二种方案——Jersey pre-matching Filter直接调用abortWith，它平衡了代码内聚性和性能，实现起来也最简洁。

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