RestAssured 4.4.0提取text/html类型错误响应报错如何处理？

问题根因 #

1. 原有配置写法错误：RestAssured.config().decoderConfig(...)仅修改了临时生成的配置副本，未赋值给RestAssured全局静态配置，因此配置完全不生效。
2. RestAssured 4.4.0版本对非2xx状态码的响应，默认会跳过部分解码器匹配逻辑，即使配置了HTML解码器也可能无法触发解析。

解决方案 #

方案1：修正全局解码器配置

如果需要全局适配text/html类型的响应，使用如下正确写法配置：

RestAssured.config = RestAssured.config()
        .decoderConfig(decoderConfig -> decoderConfig
                // 指定HTML类型响应的默认字符集
                .defaultCharsetForContentType("ISO-8859-1", ContentType.HTML)
                // 保留默认的解码方式
                .contentDecoders(DecoderConfig.ContentDecoder.DEFLATE, DecoderConfig.ContentDecoder.GZIP)
        );

配置后原有测试代码无需修改即可正常提取响应字符串。

方案2：单次请求单独注册解析器

如果仅需要针对单个错误场景适配，无需修改全局配置，在请求参数中单独注册HTML类型的文本解析器即可：

return given()
        .queryParams(incorrectParams)
        // 为本次请求的text/html类型响应注册文本解析器
        .registerParser("text/html", Parser.textParser())
        .when()
        .put("https://example.com/endpoint")
        .then()
        .statusCode(500)
        // 优先使用asString()方法提取字符串，避免不必要的类型解析
        .extract().body().asString();

方案3：手动转换原始响应字节（最稳妥）

如果不想依赖RestAssured的解析逻辑，完全绕开Content-Type校验，可以直接读取响应字节手动转字符串，适配所有响应类型：

Response response = given()
        .queryParams(incorrectParams)
        .when()
        .put("https://example.com/endpoint")
        .then()
        .statusCode(500)
        .extract().response();

// 读取响应头中的charset手动转码
String charset = response.getContentType().split("charset=")[1];
String respBody = new String(response.getBody().asByteArray(), Charset.forName(charset));
return respBody;

补充说明 #

正向测试场景运行正常是因为RestAssured默认已经为application/json类型注册了对应解析器，无需额外配置即可正常解析。

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