Springcloud?feign傳日期類(lèi)型參數(shù)報(bào)錯(cuò)的解決方案

更新時(shí)間：2022年03月14日 15:40:41 作者：weixin_33725126

這篇文章主要介紹了Springcloud?feign傳日期類(lèi)型參數(shù)報(bào)錯(cuò)的解決方案，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教

feign傳日期類(lèi)型參數(shù)報(bào)錯(cuò)

Date類(lèi)型參數(shù)報(bào)錯(cuò)

在Spring cloud feign接口中傳遞Date類(lèi)型參數(shù)時(shí)報(bào)錯(cuò)，報(bào)錯(cuò)信息。

場(chǎng)景：

客戶(hù)端傳遞一個(gè)new Date()的參數(shù)，服務(wù)端接受的參數(shù)和客戶(hù)端有時(shí)間差。

客戶(hù)端打印格式化的new Date()：

2018-05-11 10:23:36

而服務(wù)端接收到的參數(shù)是：

2018-05-12 00:23:36

我們從Feign啟動(dòng)的源碼可以看出，F(xiàn)eign在encode和decode時(shí)會(huì)用SpringEncoder類(lèi)來(lái)實(shí)現(xiàn)：

? ? @Bean
? ? @ConditionalOnMissingBean
? ? public Decoder feignDecoder() {
? ? ? ? return new ResponseEntityDecoder(new SpringDecoder(this.messageConverters));
? ? }
?
? ? @Bean
? ? @ConditionalOnMissingBean
? ? public Encoder feignEncoder() {
? ? ? ? return new SpringEncoder(this.messageConverters);
? ? }

而SpringEncoder的HttpMessageConverters使用的是Jackson默認(rèn)模板，該模板來(lái)自基類(lèi)WebMvcConfigurationSupport.java:

? ? protected final List<HttpMessageConverter<?>> getMessageConverters() {
? ? ? ? if (this.messageConverters == null) {
? ? ? ? ? ? this.messageConverters = new ArrayList<HttpMessageConverter<?>>();
? ? ? ? ? ? configureMessageConverters(this.messageConverters);
? ? ? ? ? ? if (this.messageConverters.isEmpty()) {
? ? ? ? ? ? ? ? addDefaultHttpMessageConverters(this.messageConverters);
? ? ? ? ? ? }
? ? ? ? ? ? extendMessageConverters(this.messageConverters);
? ? ? ? }
? ? ? ? return this.messageConverters;
? ? }

而WebMvcConfigurationSupport.java最終使用的是默認(rèn)的ObjectMapper生成的MappingJackson2HttpMessageConverter。

至此可以看出該問(wèn)題的產(chǎn)生并不是Feign的問(wèn)題，而是Feign實(shí)現(xiàn)中使用的Spring MVC中的Jackson轉(zhuǎn)換參數(shù)問(wèn)題，默認(rèn)的TimeZone并不是東八區(qū)，而是UTC。

? ? /**
? ? ?* Override the default {@link TimeZone} to use for formatting.
? ? ?* Default value used is UTC (NOT local timezone).
? ? ?* @since 4.1.5
? ? ?*/
? ? public Jackson2ObjectMapperBuilder timeZone(TimeZone timeZone) {
? ? ? ? this.timeZone = timeZone;
? ? ? ? return this;
? ? }

這個(gè)問(wèn)題，在Spring MVC中可以在接口或者字段上添加注解來(lái)解決，但在Feign中使用GET請(qǐng)求的接口添加注解是不行的。debug發(fā)現(xiàn)，Spring MVC在處理Date的時(shí)候，調(diào)用了sun.reflect.ConstructorAccessor#newInstance(Object[] var1)，時(shí)間會(huì)加14個(gè)小時(shí)。具體實(shí)現(xiàn)沒(méi)看到源碼，后續(xù)再研究。需要說(shuō)明的是，加JsonFormat注解對(duì)于Feign接口沒(méi)生效，但Spring MVC是可以的。

OK，回到正題。要解決這個(gè)問(wèn)題，最好的辦法是自定義ObjectMapper。即使是加了注解可以解決問(wèn)題，也依然推薦使用自定義ObjectMapper，因?yàn)榇罅康慕涌诿總€(gè)都添加注解太繁瑣了。

? ? @Bean
? ? @Primary
? ? public ObjectMapper objectMapper() {
? ? ? ? return Jackson2ObjectMapperBuilder.json()
? ? ? ? ? ? ? ? .serializationInclusion(JsonInclude.Include.NON_NULL)
? ? ? ? ? ? ? ? .featuresToDisable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS)
? ? ? ? ? ? ? ? .timeZone(TimeZone.getTimeZone("Asia/Shanghai"))
? ? ? ? ? ? ? ? .build();
? ? }

這樣注解進(jìn)去的ObjectMapper就帶了時(shí)區(qū)。

LocalDate類(lèi)型報(bào)錯(cuò)

報(bào)錯(cuò)詳情：

Failed to read HTTP message: org.springframework.http.converter.HttpMessageNotReadableException: JSON parse error: Can not construct instance of java.time.LocalDate: no suitable constructor found, can not deserialize from Object value (missing default constructor or creator, or perhaps need to add/enable type information?); nested exception is com.fasterxml.jackson.databind.JsonMappingException: Can not construct instance of java.time.LocalDate: no suitable constructor found, can not deserialize from Object value (missing default constructor or creator, or perhaps need to add/enable type information?)
at [Source: java.io.PushbackInputStream@3ce2b1e2; line: 1, column: 44] (through reference chain: com.chunrun.user.param.UserParams["localDate"])

這是因?yàn)長(zhǎng)ocalDate沒(méi)有提供默認(rèn)的構(gòu)造器，而Jackson還不支持Java8的特征。這時(shí)候只需要加上依賴(lài)，ObjectMapper加一行代碼即可：

? ? <dependency>
? ? ? <groupId>com.fasterxml.jackson.datatype</groupId>
? ? ? <artifactId>jackson-datatype-jsr310</artifactId>
? ? ? <version>2.4.0</version>
? ? </dependency>

? ? @Bean
? ? @Primary
? ? public ObjectMapper objectMapper() {
? ? ? ? return Jackson2ObjectMapperBuilder.json()
? ? ? ? ? ? ? ? .serializationInclusion(JsonInclude.Include.NON_NULL)
? ? ? ? ? ? ? ? .featuresToDisable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS)
? ? ? ? ? ? ? ? .timeZone(TimeZone.getTimeZone("Asia/Shanghai"))
? ? ? ? ? ? ? ? .modules(new JSR310Module())
? ? ? ? ? ? ? ? .build();
? ? }

以上配置調(diào)用方也需要。

feign傳參問(wèn)題及傳輸Date類(lèi)型參數(shù)時(shí)差的坑

feign的調(diào)用如下：

List<LeftSeatCountOfDaysResp> getLeftSeatCountOfDays(
            @RequestParam("configType") Integer configType,
            @RequestParam("courseId") Long courseId,
            @RequestParam("startDateFrom") Date startDateFrom,
            @RequestParam("startDateTo") Date startDateTo,
            @RequestParam("level") Integer level);

我們采用了兩個(gè)date類(lèi)型的參數(shù)傳參，結(jié)果：

我們傳入的時(shí)間為：

但服務(wù)端接受到的時(shí)間為：

天啊擼，竟然出現(xiàn)了我們并不熟悉的14h時(shí)差，并不是我們熟悉的8個(gè)小時(shí)。feign真是天坑啊。這是SpringCloud Feign傳Date類(lèi)型參數(shù)的時(shí)差導(dǎo)致的。

備注：使用date類(lèi)型傳參，如果是body里面用對(duì)象傳，是不會(huì)出現(xiàn)時(shí)差問(wèn)題的。

下面說(shuō)說(shuō)兩種解決方案

當(dāng)發(fā)送時(shí)間類(lèi)型時(shí)，直接用String發(fā)送（推薦）
Feign客戶(hù)端實(shí)現(xiàn)FeignFormatterRegistrar接口自定義DateFormatRegister

@Component
    public class DateFormatRegister implements FeignFormatterRegistrar{
        public DateFormatRegister(){
        }
        @Override
        public void registerFormatters(FormatterRegistry registry) {
        registry.addConverter(Date.class, String.class, new Date2StringConverter()); 
        }
        private class Date2StringConverter implements Converter<Date,String>{
            @Override
            public String convert(Date source) {
            SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
            return sdf.format(source);
            }
        }
    }

服務(wù)端實(shí)現(xiàn)：

@Configuration
    public class WebConfigBeans {
        @Autowired
        private RequestMappingHandlerAdapter handlerAdapter;
        /**
        * 增加字符串轉(zhuǎn)日期的功能
        */
        @PostConstruct
        public void initEditableValidation() {
            ConfigurableWebBindingInitializer initializer = (ConfigurableWebBindingInitializer) handlerAdapter
                        .getWebBindingInitializer();
            if (initializer.getConversionService() != null) {
                GenericConversionService genericConversionService = (GenericConversionService) initializer
                            .getConversionService();
                genericConversionService.addConverter(String.class, Date.class, new String2DateConverter());
            }
        }
    }

第二種比較麻煩，但是一勞永逸，代碼的優(yōu)雅性比第一種好。但個(gè)人而言，還是推薦使用第一種。

feign傳參時(shí)候使用@DateTimeFormat注解的坑

@NotNull
    @MyFuture
    @DateTimeFormat(pattern = "yyyy-MM-dd")
    private Date appointDate; //預(yù)定的預(yù)成班日期

比如這個(gè)字段，服務(wù)端上面用了@DateTimeFormat注解，這樣的話，springMVC手機(jī)支持直接傳字符串2018-03-03自動(dòng)轉(zhuǎn)換的。但是，但是，如果你是用client調(diào)用，那就不報(bào)錯(cuò)啦，報(bào)錯(cuò)啦。所以使用的時(shí)候，一定要注意啊，一定要注意啊。

小結(jié)：雖然fiegn有很多坑，但咱不能說(shuō)feign不好用。畢竟他比restTemplate或者h(yuǎn)ttpClient還是優(yōu)雅很多的，能夠簡(jiǎn)化很多東西，負(fù)載均衡也做得不錯(cuò)，畢竟在本地就可以做。

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。

您可能感興趣的文章: