RestEasy客户端自动抛出异常咨询：401授权失败场景

这事儿我熟！RestEasy作为JAX-RS客户端，默认行为就是把HTTP错误状态码（比如401、404这类4xx/5xx）转换成对应的Java异常抛出，而不是直接返回服务器的响应体——这和Postman这种纯HTTP客户端的逻辑完全不一样，Postman只是原封不动把服务器返回的所有内容给你，所以你能看到401和自定义错误体，而RestEasy直接给你抛了NotAuthorizedException（对应401），也就是你看到的EJB Invocation failed异常的根源。

解决办法有几种，按需选择： #

1. 捕获异常，从异常中提取响应体

NotAuthorizedException是WebApplicationException的子类，它内部持有服务器返回的Response对象，你可以直接从异常里拿到这个响应，然后读取自定义的错误体：

try {
    AuthToken token = gatewayApi.authenticate(...);
    // 正常处理逻辑
} catch (NotAuthorizedException authEx) {
    Response errorResponse = authEx.getResponse();
    // 先定义一个和错误体结构匹配的实体类，比如ErrorResponse
    ErrorResponse error = errorResponse.readEntity(ErrorResponse.class);
    
    // 现在就能拿到错误码和信息了
    System.out.println("授权失败：" + error.getErrors().get(0).getMessage());
    
    // 别忘了关闭响应，避免资源泄漏
    errorResponse.close();
}

2. 修改接口方法返回Response对象

如果你想完全掌控响应处理，可以把GatewayApi接口里的authenticate方法返回类型从AuthToken改成Response，这样调用时会拿到完整的HTTP响应，自己判断状态码再处理：

// 修改后的接口方法
@POST
@Path("/authenticate")
Response authenticate(...);

// 调用逻辑
Response response = gatewayApi.authenticate(...);
int statusCode = response.getStatus();

if (statusCode == 200) {
    // 成功，解析业务对象
    AuthToken token = response.readEntity(AuthToken.class);
    // 处理成功逻辑
} else if (statusCode == 401) {
    // 授权失败，解析错误体
    ErrorResponse error = response.readEntity(ErrorResponse.class);
    // 处理错误逻辑
}

// 关闭响应
response.close();

3. 全局配置客户端，禁用自动异常转换（不推荐，除非全局需要）

你可以给RestEasy客户端注册一个响应过滤器，或者设置属性来阻止它自动抛出异常，但这种方式会影响所有请求的处理逻辑，除非你有全局统一的错误处理需求，否则前面两种方法更灵活：

// 创建客户端时注册过滤器
Client client = ClientBuilder.newBuilder()
        .register(new ClientResponseFilter() {
            @Override
            public void filter(ClientRequestContext requestContext, ClientResponseContext responseContext) throws IOException {
                // 这里可以自定义处理错误响应，比如阻止异常抛出
                // 不过更简单的还是用前面的捕获或返回Response的方式
            }
        })
        .build();

补充说明 #

为什么Postman能正常拿到响应？因为Postman是纯HTTP工具，它不关心JAX-RS规范，只是把服务器返回的状态码、响应头、响应体原封不动展示给你；而RestEasy作为JAX-RS实现，遵循规范默认将错误状态码映射为异常，目的是让开发者用Java的异常处理机制来处理HTTP错误，但这就需要你手动从异常中提取响应体，或者主动获取完整的Response对象。

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