SpringBoot结合PostgreSQL实现入参与响应日期格式差异化适配

首先明确核心矛盾：@JsonFormat这类注解是双向生效的，一旦直接打在实体类字段上，会同时作用于「请求入参的反序列化」和「响应出参的序列化」两个环节。要是直接配成DD-MM-YYYY，就会把入参的解析规则也改了，导致前端传的YYYY-MM-DD格式无法正常解析，自然没法给PostgreSQL正常落库；反过来配成YYYY-MM-DD，返回给前端的格式又不符合要求。要解决这个问题，本质就是把入参解析和出参序列化的规则拆分开，互不干扰。

入参侧：固定YYYY-MM-DD解析规则，满足数据库存储要求 #

这部分完全不需要修改实体类，通过全局Jackson配置统一管控所有请求入参的日期解析逻辑：

• 自定义全局Jackson反序列化规则，针对LocalDate、Date这类日期类型，统一按照yyyy-MM-dd格式做入参解析
• 示例配置代码：

@Configuration
public class WebDateConfig implements WebMvcConfigurer {
    @Bean
    public Jackson2ObjectMapperBuilderCustomizer fixedDateDeserialization() {
        return builder -> {
            // 所有入参的日期类型，强制按yyyy-MM-dd格式解析
            DateTimeFormatter dateFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd");
            builder.deserializerByType(LocalDate.class, new LocalDateDeserializer(dateFormatter));
        };
    }
}

• 配置完成后，不管前端POST提交的保存、编辑接口传的日期是yyyy-MM-dd格式，后端都会正常解析为Java标准日期对象，传入PostgreSQL时完全符合数据库的存储识别要求，不会出现格式报错。

出参侧：按需配置DD-MM-YYYY的返回格式 #

这部分不需要改动全局规则，两种零侵入的实现方式可以根据团队习惯选：

• 方式1：分离持久层实体和接口响应VO
  不要直接把数据库Entity对象当接口返回值吐给前端，单独为查询类接口创建专用的响应VO类，在VO的日期字段上通过@JsonFormat指定dd-MM-yyyy的序列化格式即可。
  示例代码：

// 专门用于用户列表查询响应的VO，仅用于出参，不接收入参
public class UserListVO {
    private Long id;
    private String nickname;
    // 仅序列化（出参）时转换为DD-MM-YYYY格式
    @JsonFormat(pattern = "dd-MM-yyyy")
    private LocalDate registerDate;
}

这种方式的好处是，因为这个VO从来不会被用来接收入参，@JsonFormat只会作用在序列化（返回前端）的环节，完全不会干扰之前配置的全局入参解析规则。

• 方式2：自定义定向序列化注解
  如果团队不想额外拆VO，也可以自定义一个带日期格式参数的注解，标记在需要返回特殊格式的接口或字段上，通过Jackson的序列化拦截器，在生成响应JSON时，把对应日期字段的格式替换为dd-MM-yyyy。没有加注解的接口，默认还是用全局的序列化格式返回，互不影响。

关键避坑提示 #

• 绝对不要把日期格式的@JsonFormat直接打在持久层Entity的字段上。Entity类通常是双向复用的：既会被绑定来接收POST入参，又会被直接当响应返回，打注解后会把入参的解析规则也改成dd-MM-yyyy，直接和我们要求的入参格式冲突。
• 实际PostgreSQL本身存储日期是不依赖前端传入的字符串格式的，只要后端Java端把入参解析成标准的LocalDate对象，不管返回前端时转成啥格式，数据库内部存储的都是标准的日期值，不会影响落库正确性。

内容的提问来源于stack exchange，提问作者Denis Stojković Stole