夢の終着駅

一、问题简述#

1
        <dependency>
2
            <groupId>com.alibaba.fastjson2</groupId>
3
            <artifactId>fastjson2</artifactId>
4
            <version>2.0.36</version>
5
        </dependency>

当我们引入阿里的依赖时，在实体类的日期字段上加了注释指定了日期格式，但在前端传入数据后却报错：

2025-08-01T17:04:24.402+08:00  WARN 864 --- [io-10044-exec-1] .w.s.m.s.DefaultHandlerExceptionResolver : Resolved [org.springframework.web.bind.MethodArgumentNotValidException: Validation failed for argument [0] in public com.Yilena.Coupon.framework.result.Result<java.lang.Void> com.Yilena.MyOneCoupon.merchantAdmin.controller.CouponTemplateController.createCouponTemplate(com.Yilena.MyOneCoupon.merchantAdmin.entry.DTO.request.CouponTemplateSaveReqDTO) with 2 errors: [Field error in object ‘couponTemplateSaveReqDTO’ on field ‘validEndTime’: rejected value [2025-07-08 12:00:00]; codes [typeMismatch.couponTemplateSaveReqDTO.validEndTime,typeMismatch.validEndTime,typeMismatch.java.util.Date,typeMismatch]; arguments [org.springframework.context.support.DefaultMessageSourceResolvable: codes [couponTemplateSaveReqDTO.validEndTime,validEndTime]; arguments []; default message [validEndTime]]; default message [Failed to convert property value of type ‘java.lang.String’ to required type ‘java.util.Date’ for property ‘validEndTime’; Failed to convert from type [java.lang.String] to type [@com.fasterxml.jackson.annotation.JsonFormat @io.swagger.v3.oas.annotations.media.Schema java.util.Date] for value [2025-07-08 12:00:00]]] [Field error in object ‘couponTemplateSaveReqDTO’ on field ‘validStartTime’: rejected value [2024-07-08 12:00:00]; codes [typeMismatch.couponTemplateSaveReqDTO.validStartTime,typeMismatch.validStartTime,typeMismatch.java.util.Date,typeMismatch]; arguments [org.springframework.context.support.DefaultMessageSourceResolvable: codes [couponTemplateSaveReqDTO.validStartTime,validStartTime]; arguments []; default message [validStartTime]]; default message [Failed to convert property value of type ‘java.lang.String’ to required type ‘java.util.Date’ for property ‘validStartTime’; Failed to convert from type [java.lang.String] to type [@com.fasterxml.jackson.annotation.JsonFormat @io.swagger.v3.oas.annotations.media.Schema java.util.Date] for value [2024-07-08 12:00:00]]] ]  

报错很长，但仔细看一下就会发现是日期的格式解析失败，也就是日期格式期望不一致，让我们看看的对应字段的代码：

1
    @Schema(description = "有效期开始时间",
2
            example = "2024-07-08 12:00:00",
3
            required = true)
4
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
5
    private Date validStartTime;

可以看到指定的格式和传入的格式是一样的，那为什么会报错呢？

这里其实是 MVC的默认日期转化器将FastJson给覆盖了，底层是将非Json请求体和Json请求体的转换给分隔开的。

二、#

1
package com.Yilena.MyOneCoupon.merchantAdmin.config;
2

3
import org.springframework.context.annotation.Configuration;
4
import org.springframework.format.FormatterRegistry;
5
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
6
import java.text.SimpleDateFormat;
7
import java.util.Date;
8

9
/**
10
 * 配置日期转换器的类
11
 * 用于统一日期格式的解析和格式化
12
 */
13
@Configuration
14
public class DateConverterConfiguration implements WebMvcConfigurer {
15

16
    /**
17
     * 向FormatterRegistry中添加日期格式的转换器
18
     * 这样可以全局配置日期格式的解析和格式化方式
19
     */
20
    @Override
21
    public void addFormatters(FormatterRegistry registry) {
22
        registry.addFormatterForFieldType(Date.class, new DateFormatter());
23
    }
24

25
    /**
26
     * 日期格式转换器类
27
     * 用于将日期字符串转换为Date对象，或将Date对象转换为日期字符串
28
     * 格式为"yyyy-MM-dd HH:mm:ss"，时区为GMT+8
29
     */
30
    static class DateFormatter implements org.springframework.format.Formatter<Date> {
31
        private final SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
32

33
        /**
34
         * 将日期字符串解析为Date对象
35
         * 在解析过程中设置时区为GMT+8，以确保时间的正确性
36
         */
37
        @Override
38
        public Date parse(String text, java.util.Locale locale) throws java.text.ParseException {
39
            format.setTimeZone(java.util.TimeZone.getTimeZone("GMT+8"));
40
            return format.parse(text);
41
        }
42

43
        /**
44
         * 将Date对象格式化为日期字符串
45
         * 在格式化过程中设置时区为GMT+8，以确保时间的正确性
46
         */
47
        @Override
48
        public String print(Date object, java.util.Locale locale) {
49
            format.setTimeZone(java.util.TimeZone.getTimeZone("GMT+8"));
50
            return format.format(object);
51
        }
52
    }
53
}