Spring Boot和Feign中使用Java 8時間日期API（LocalDate等）的序列化問題

LocalDate

、

LocalTime

LocalDateTime

是Java 8開始提供的時間日期API，主要用來優化Java 8以前對于時間日期的處理操作。然而，我們在使用Spring Boot或使用Spring Cloud Feign的時候，往往會發現使用請求參數或傳回結果中有

LocalDate

LocalTime

LocalDateTime

的時候會發生各種問題。本文我們就來說說這種情況下出現的問題，以及如何解決。

https://blog.didispace.com/Spring-Boot-And-Feign-Use-localdate/#%E9%97%AE%E9%A2%98%E7%8E%B0%E8%B1%A1 問題現象

先來看看症狀。比如下面的例子：

@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }

    @RestController
    class HelloController {

        @PostMapping("/user")
        public UserDto user(@RequestBody UserDto userDto) throws Exception {
            return userDto;
        }

    }

    @Data
    @NoArgsConstructor
    @AllArgsConstructor
    static class UserDto {

        private String userName;
        private LocalDate birthday;

    }

}      

上面的代碼建構了一個簡單的Spring Boot Web應用，它提供了一個送出使用者資訊的接口，使用者資訊中包含了

LocalDate

類型的資料。此時，如果我們使用Feign來調用這個接口的時候，會得到如下錯誤：

2018-03-13 09:22:58,445 WARN  [http-nio-9988-exec-3] org.springframework.web.servlet.mvc.support.DefaultHandlerExceptionResolver - 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@67064c65; line: 1, column: 63] (through reference chain: java.util.ArrayList[0]->com.didispace.UserDto["birthday"])      

分析解決

對于上面的錯誤資訊

JSON parse error: Can not construct instance of java.time.LocalDate: no suitable constructor found, can not deserialize from Object value

，熟悉Spring MVC的童鞋應該馬上就能定位錯誤與

LocalDate

的反序列化有關。但是，依然會有很多讀者會被這段錯誤資訊

java.util.ArrayList[0]->com.didispace.UserDto["birthday"]

所困惑。我們命名送出的

UserDto["birthday"]

是個

LocalDate

對象嘛，跟

ArrayList

清單對象有啥關系呢？

我們不妨通過postman等手工發一個請求看看服務端傳回的是什麼？比如你可以按下圖發起一個請求：

從上圖中我們就可以了解上面我所提到的困惑了，實際上預設情況下Spring MVC對于

LocalDate

序列化成了一個數組類型，而Feign在調用的時候，還是按照

ArrayList

來處理，是以自然無法反序列化為

LocalDate

對象了。

解決方法

為了解決上面的問題非常簡單，因為jackson也為此提供了一整套的序列化方案，我們隻需要在

pom.xml

中引入

jackson-datatype-jsr310

依賴，具體如下：

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

注意：在設定了spring boot的parent的情況下不需要指定具體的版本，也不建議指定某個具體版本

在該子產品中封裝對Java 8的時間日期API序列化的實作，其具體實作在這個類中：

com.fasterxml.jackson.datatype.jsr310.JavaTimeModule

（注意：一些較早版本瘋轉在這個類中“

com.fasterxml.jackson.datatype.jsr310.JSR310Module

）。在配置了依賴之後，我們隻需要在上面的應用主類中增加這個序列化子產品，并禁用對日期以時間戳方式輸出的特性：

此時，我們在通路剛才的接口，就不再是數組類型了，同時對于Feign用戶端的調用也不會再出現上面的錯誤了。

https://blog.didispace.com/Spring-Boot-And-Feign-Use-localdate/#%E4%BB%A3%E7%A0%81%E7%A4%BA%E4%BE%8B 代碼示例

本文的相關例子可以檢視下面倉庫中的

Chapter3-1-7

目錄：

• Github：https://github.com/dyc87112/SpringBoot-Learning
• Gitee：https://gitee.com/didispace/SpringBoot-Learning