日期格式化時注解@DateTimeFormat無效的問題分析
背景
有時候我們在寫接口時，需要把前台傳來的日期String類型轉為Date類型
這時我們可能會用到@DateTimeFormat注解
在請求數據為非JSON格式時，這個注解是沒有問題的，可用的；
但是當請求數據為JSON格式時，問題就出現了
此時如果請求參數沒有加@RequestBody注解，那么請求參數不會執行類型轉換操作，數據都是默認為空（基本類型比如int = 0, 對象引用比如Date date= null)
此時如果請求參數有加@RequestBody注解，那么請求參數會執行JSON類型轉換操作，但是轉換會提示異常
所以文章題目中所說的有時無效，指的就是上面這兩種情況
目錄
本文分三步走，如下所示，其中會穿插着介紹@DateTimeFormat、@RequestBody、@JsonFormat注解
分析
1. 基礎代碼：
AnnationApplication.java：主程序兼控制器
package com.jalon.annation; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.RestController; @SpringBootApplication @RestController public class AnnationApplication { public static void main(String[] args) { SpringApplication.run(AnnationApplication.class, args); } @PostMapping("/personPost") public Person personPost(Person person){ System.out.println(person); return person; } }
Person.java 實體類
package com.jalon.annation; import com.fasterxml.jackson.annotation.JacksonAnnotation; import org.springframework.format.annotation.DateTimeFormat; import org.springframework.stereotype.Component; import java.util.Date; public class Person { private int age; @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") private Date birth; @Override public String toString() { return "Person{" + "age=" + age + ", birth=" + birth + '}'; } // 省略getter/setter }
2. 案例分析：
這里我們用的是PostMan進行測試，請求示例如下
所有示例全程都有@DateTimeFormat注解
示例1:
-
請求方式：Post請求
-
數據格式：非JSON格式，比如form-data
-
請求資源：personPost(Person person)，無@RequestBody注解
具體請求內容和返回結果如下所示
@ResponseBody對應於@RequestBody；
- 前者負責將Java對象序列號成JSON數據進行返回
- 后者負責解析請求過來的JSON數據，解析成對應的Java對象
我們再來看下后台，打印如下：
Person{age=1, birth=Wed Jan 01 00:00:00 CST 2020}
可以看到，后台打印正常（數據無誤，日期格式忽略，因為這里的date.toString用的Date的默認方法）
從上面的結果我們可以看到，@DateTimeFormat只是負責解析傳來的日期字符串，轉為對應的日期對象；
但是並不會修改原有的日期對象的格式（從前台返回和后台輸出可以看到，日期格式不受@DateTimeFormat的影響）
示例2:
-
請求方式：Post請求
-
數據格式：JSON格式，比如application/json
-
請求資源：personPost(Person person)，無@RequestBody注解
具體請求內容和返回結果如下所示
可以看到，返回數據都為空（默認的初始值）,說明數據都沒有傳過去，不止是date,連基本類型int都沒過去
我們再來看下后台，打印如下
Person{age=0, birth=null} // 跟前台返回的數據一致
可以看到，后台解析到的數據也是空的，所以上面返回的當然是空的
原因就是默認的類型轉換器是沒有轉化成JSON格式的對應轉換類的，部分轉換器如下所示,（core.convert.support包）
解決：所以這里對應的解決辦法就是，自己創建一個JSON轉換器
但是實際上這個已經有實現了，只是沒有觸發，如下所示的構建工具(http.converter.json包)，就是用來配置相關的json序列化和反序列化的
現在我們可以通過@RequestBody注解來觸發，它在接收到JSON格式的數據時，會自動調用對應的JSON轉換器
下面的示例3就是這個例子
加了@RequestBody后，默認只接受application/json格式的數據，如果傳入其他格式，會報415不支持的類型
示例3:
-
請求方式：Post請求
-
數據格式：JSON格式，比如application/json
-
請求資源：personPost(@RequestBody Person person)，有@RequestBody注解
具體請求內容和返回結果如下所示
可以看到，報錯了，提示400，這種一般屬於客戶端錯誤（比如數據格式不正確，數據過大等）
我們再來看下后台，打印如下
2021-05-15 13:48:41.578 WARN 38426 --- [nio-8080-exec-2] .w.s.m.s.DefaultHandlerExceptionResolver : Resolved [org.springframework.http.converter.HttpMessageNotReadableException: JSON parse error: Cannot deserialize value of type `java.util.Date` from String "2020-01-01 00:00:00": not a valid representation (error: Failed to parse Date value '2020-01-01 00:00:00': Cannot parse date "2020- 01-01 00:00:00": while it seems to fit format 'yyyy-MM-dd'T'HH:mm:ss.SSSX', parsing fails (leniency? null)); nested exception is com.fasterxml.jackson.databind.exc.InvalidFormatException: Cannot deserialize value of type `java.util.Date` from String "2020-01-01 00:00:00": not a valid representation (error: Failed to parse Date value '2020-01-01 00:00:00': Cannot parse date "2020-01-01 00:00:00": while it seems to fit format 'yyyy-MM-dd'T'HH:mm:ss.SSSX', parsing fails (leniency? null)) at [Source: (PushbackInputStream); line: 3, column: 14] (through reference chain: com.jalon.annation.Person["birth"])]
這里我們提取關鍵的部分來看：
1. nested exception is com.fasterxml.jackson.databind.exc.InvalidFormatException: Cannot deserialize value of type `java.util.Date` from String "2020-01-01 00:00:00" 2. Cannot parse date "2020-01-01 00:00:00": while it seems to fit format 'yyyy-MM-dd'T'HH:mm:ss.SSSX'
首先這里跟示例2不同，這里起碼做了嘗試轉換，只是沒有找到對應的格式，所以轉換失敗了
可以看到，它並沒有按照上面我們的@DateTimeFormat注解去解析，而是按照’'yyyy-MM-dd’T’HH:mm:ss.SSSX"這個格式去解析
這里如果想投機的話，可以在前台直接傳入’'yyyy-MM-dd’T’HH:mm:ss.SSSX’格式的數據，如下：
但是這種辦法對於前端很不友好（極其不好）
所以下面還是給出正常的解決辦法
解決：所以這里的解決辦法就是自己定義日期格式
- 方案一：局部注解來解決，比如在date字段添加@JsonFormat()注解
// 這個注解用來解析JSON數據中的日期字符串，會序列化返回數據 @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") private Date birth;
局部的特點：靈活，但是配置繁瑣，不統一（每個字段都要加）
- 方案二：全局配置來解決，比如配置一個Jackson2ObjectMapperBuilderCustomizer，然后自定義日期反序列化格式
package com.jalon.annation; import com.fasterxml.jackson.databind.deser.std.DateDeserializers; import org.springframework.boot.autoconfigure.jackson.Jackson2ObjectMapperBuilderCustomizer; import org.springframework.context.annotation.Configuration; import org.springframework.http.converter.json.Jackson2ObjectMapperBuilder; import java.text.SimpleDateFormat; import java.util.Date; @Configuration public class MyDateConvertCustoms implements Jackson2ObjectMapperBuilderCustomizer { @Override public void customize(Jackson2ObjectMapperBuilder jacksonObjectMapperBuilder) { // 覆蓋默認的Date反序列化，第一個參數為需要反序列化的類，第二個為具體的序列化格式 jacksonObjectMapperBuilder.deserializerByType( Date.class ,new DateDeserializers.DateDeserializer( DateDeserializers.DateDeserializer.instance , new SimpleDateFormat("yyyy-MM-dd HH:mm:ss") , null)); } }
全局的特點：不靈活，但是直觀清晰，配置統一
3. 結論分析：
主要根據請求的數據類型來對比
請求非JSON數據，建議用@DateTimeFormat即可（比如get請求，當然get請求也可以請求JSON數據，只是不推薦）
請求JSON數據，建議用@ReqeustBody來轉換數據，然后搭配局部注解@JsonFormat或者全局配置來修改默認的日期解析格式(默認"yyyy-MM-dd’T’HH:mm:ss.SSSX")
總結
注解相關：
@DateTimeFormat注解：適用於請求數據為非JSON數據，不會格式化返回數據
@JsonFormat注解：適用於請求數據為JSON數據（尤其有日期數據時），且需在請求方法的參數前加@RequestBody`注解，會格式化返回數據
@RequestBody注解：解析傳來的JSON數據，轉換成對應的Java對象
@ResponseBody注解：轉換Java對象為JSON數據，用來作為返回數據輸出到前端
日期格式化相關：
請求非JSON數據，建議用@DateTimeFormat即可，此時不會格式化返回數據（比如get請求，當然get請求也可以請求JSON數據，只是不推薦）
請求JSON數據，建議用@ReqeustBody來轉換數據，然后搭配局部注解@JsonFormat（會格式化返回數據）或者全局配置來修改默認的日期解析格式(默認"yyyy-MM-dd’T’HH:mm:ss.SSSX")；全局配置也可以格式化返回數據，需配置builder.serializerByType
如果日期格式化出錯，先看傳來的數據是否為JSON數據(可以通過consumes來限制)，然后再看有沒有對於的注解或日期格式化全局配置
轉載：https://blog.csdn.net/qq_43842093/article/details/121986444
