Quarkus 3.0.3 Final中Rest Client的Response.getEntity()为何返回null？

问题场景 #

在Quarkus 3.0.3 Final中定义了Rest Client接口，并注册了ErrorMapper处理错误响应。响应头显示存在content-length: [148]和content-type: [application/json]，但调用response.getEntity()返回null，导致空指针异常，无法获取JSON响应体处理下游错误码。

原因分析 #

Quarkus基于RESTEasy实现的Rest Client中，当ExceptionMapper（即你定义的ErrorMapper）触发时，响应实体可能已被框架预读取，或者getEntity()返回的对象并非预期的ByteArrayInputStream，直接强制转换会导致失败并返回null。

可行解决方案 #

方案1：使用Response.readEntity()直接读取 #

利用框架提供的readEntity()方法，自动处理响应体的读取和类型转换，无需手动操作输入流：

private String getBody(Response response) throws IOException {
    response.getStringHeaders().forEach((s, strings) -> logger.info(s + ": " + strings.toString()));
    
    try {
        // 直接读取为String，框架会匹配content-type自动处理
        return response.readEntity(String.class);
    } catch (ProcessingException e) {
        logger.error("读取响应体失败", e);
        return "";
    }
}

方案2：通过MessageBodyReader手动读取 #

如果需要更底层的控制，可借助MessageBodyReader来读取响应流：

private String getBody(Response response) throws IOException {
    response.getStringHeaders().forEach((s, strings) -> logger.info(s + ": " + strings.toString()));
    
    MessageBodyReader<String> reader = response.getConfiguration()
            .getMessageBodyReader(String.class, String.class, 
                    new Annotation[0], MediaType.APPLICATION_JSON_TYPE);
    
    if (reader != null) {
        try (InputStream is = response.getEntityStream()) {
            return reader.readFrom(String.class, String.class, 
                    new Annotation[0], MediaType.APPLICATION_JSON_TYPE,
                    response.getHeaders(), is);
        }
    }
    return "";
}

关键注意点 #

• 禁止强制转换response.getEntity()为ByteArrayInputStream，实体的实际类型由框架根据响应场景动态决定，硬转极易出错。
• 调用readEntity()后，响应流会被自动关闭，若需多次读取实体，需先调用response.bufferEntity()将实体缓存到内存中。

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