简单的text/html无法解析解决记录

1. bug发现

我们所有的服务都是微服务，服务间调用都是使用feign接口进行调用，正常调用都没有问题，但是某一天发现部分从esb服务调用过来到我们本地的服务，本地服务再使用feign接口调用其他微服务子模块时候，返回信息报错，提示信息如下：

could not extract response: no suitable HttpMessageConverter found for response type [cn.git.query.dto.CheckDTO] and content type [text/html;charset=UTF-8]

2. 解决方法

我们从esb调用服务过来，本身我们自己的转发网关接收text/json类型的请求也是处理不了的，所以添加了对应的处理类WebMvcConfig，具体如下

package cn.git.server.config;

import cn.git.api.util.NewCoreProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.MediaType;
import org.springframework.http.converter.json.MappingJackson2HttpMessageConverter;

import java.util.ArrayList;
import java.util.List;

/**
 * 解决text/json无法识别问题
 * @program: bank-credit-sy
 * @author: lixuchun
 * @create: 2022-02-10
 */
@Configuration
public class WebMvcConfig {

    /**
     * 新增请求类型
     * @return MappingJackson2HttpMessageConverter 处理类
     */
    @Bean
    public MappingJackson2HttpMessageConverter getMappingJackson2HttpMessageConverter() {
        MappingJackson2HttpMessageConverter mappingJackson2HttpMessageConverter = new MappingJackson2HttpMessageConverter();
        //设置MediaType
        List<MediaType> list = new ArrayList<>();
        list.add(MediaType.APPLICATION_JSON_UTF8);
        // text/json;charset=UTF-8
        list.add(MediaType.valueOf(NewCoreProperties.RESPONSE_TYPE_TEXT_JSON));
        mappingJackson2HttpMessageConverter.setSupportedMediaTypes(list);
        return mappingJackson2HttpMessageConverter;
    }

}

我们的响应类型，则设置了text/html;charset=UTF-8，其中 RESPONSE_TYPE_TEXT = “text/html;charset=UTF-8”,此处响应类型text/html与微服务的响应类型不匹配,无法解析报错，此处信息无法修改，所以需要修改接口调用api部分 具体代码为：

最终为了方便处理，使用了produces ，定了此端点在成功处理请求后，响应的内容类型应该是指定格式，一般为APPLICATION_JSON_VALUE,具体修改代码如下：

    /**
     * 校验该柜员是否存在未制定贷款到期前或到期后处置计划的贷款
     * @param checkDTO userCd 柜员编号 orgCd 机构编号
     * @return String 0-不存在可以发起 1-存在记录不允许发起
     */
    @ApiOperation(value = "校验是否存在未制定贷款到期前或到期后处置计划的贷款", notes = "校验是否存在未制定贷款到期前或到期后处置计划的贷款")
    @ApiResponses({@ApiResponse(code = 1, message = "OK", response = String.class),
    @ApiResponse(code = -1, message = "ERROR", response = CommonDbInfoDTO.class)})
    @PostMapping(value = "/checkDisposalPlan", produces = {MediaType.APPLICATION_JSON_VALUE})
    CheckDTO checkDisposalPlan(@RequestBody CheckDTO checkDTO);

    /**
     * 校验柜员是否进行准入
     * 该柜员没有准入，请联系管理员！
     * @param userCd 客户经理柜员号 specificLoanType 贷款品种
     * @return Boolean true-准入 false-没准入（提示）
     */
    @ApiOperation(value = "校验柜员是否准入", notes = "校验柜员是否准入")
    @ApiResponses({@ApiResponse(code = 1, message = "OK", response = String.class),
            @ApiResponse(code = -1, message = "ERROR", response = CommonDbInfoDTO.class)})
    @PostMapping(value ="/checkUserStatus/{userCd}/{specificLoanType}", produces = {MediaType.APPLICATION_JSON_VALUE})
    Boolean checkUserStatus(@PathVariable(value = "userCd") String userCd,
                            @PathVariable(value = "specificLoanType") String specificLoanType);

其中produces主要作用如下：

• 内容协商：当客户端发起请求时，可能会在请求头中包含Accept字段，表明它可以接受哪些类型的响应内容。服务器会根据客户端的偏好和produces指定的内容类型进行匹配，从而决定返回哪种类型的内容给客户端。这样可以确保客户端能够理解并处理接收到的数据
• 自动序列化：在Spring应用中，比如当指定了响应类型为application/json时，Spring会自动使用如Jackson这样的库将Java对象转换成JSON格式的字符串，然后作为响应体返回。这对于RESTful API而言非常有用，因为JSON是一种广泛支持的数据交换格式
• 清晰的API契约：明确指定响应类型可以让API的使用者清楚地知道该接口会返回什么类型的数据，有助于前后端分离开发和第三方集成