使用Jersey-Client 1.8遇HTTP 204无内容触发UniformInterfaceException问题

嘿，这个问题我之前帮人排查过好多次，Jersey 1.8在处理HTTP 204无内容响应时确实会踩这个坑！你遇到的UniformInterfaceException，本质原因是HTTP 204响应本身就不携带任何实体内容，但你调用了getEntity()方法去解析不存在的实体，Jersey 1.8的源码里直接把这种情况判定为异常抛出了。

下面给你两个实用的解决方案，按需选择：

方案1：先判断状态码，再决定是否解析实体 #

这是最直接的处理方式，先拿到ClientResponse对象，检查状态码是不是204，如果是就跳过getEntity()的调用，否则正常解析。示例代码如下：

// 发送DELETE请求并获取响应
ClientResponse response = webResource
        .header(HEADER_AUTH, getAuthToken())
        .delete(ClientResponse.class);

// 处理204无内容的情况
if (response.getStatus() == 204) {
    // 这里可以根据业务需求返回成功标识，比如true
    return true;
} else {
    // 正常解析响应实体
    YourEntityClass resultEntity = response.getEntity(YourEntityClass.class);
    // 后续业务逻辑处理
    return resultEntity != null;
}

这种方式逻辑清晰，代码可读性高，适合单个接口的特殊处理。

方案2：全局配置Client忽略204的异常 #

如果你的测试框架里有很多接口都可能返回204，不想重复写状态判断，可以给Client做全局配置，让它不把204当成异常抛出。通过自定义ClientResponseStatusExceptionMapper来实现：

// 创建Client配置对象
ClientConfig config = new DefaultClientConfig();

// 添加自定义的状态异常映射器，忽略204状态
config.getSingletons().add(new ClientResponseStatusExceptionMapper() {
    @Override
    public WebApplicationException toThrowable(ClientResponse response) {
        // 如果是204，返回null表示不抛出异常
        if (response.getStatus() == 204) {
            return null;
        }
        // 其他状态码按默认规则处理
        return ClientResponseStatusExceptionMapper.DEFAULT.toThrowable(response);
    }
});

// 使用配置好的config创建Client
Client client = Client.create(config);

配置完成后，所有通过这个Client发送的请求，遇到204响应都不会再抛出异常，你可以正常获取响应对象后按需处理。

最后补充下：Jersey 1.8的ClientResponse.getEntity()方法里，会对状态码做校验，当状态是204时直接抛出异常——虽然204是HTTP成功状态，但因为它的规范就是无实体，所以Jersey把这种“试图读取不存在实体”的操作判定为异常了。

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