SpringBoot中Java 8日期类型的序列化解决方案

1. 问题背景：为什么SpringBoot默认不支持Java 8日期类型

当你在SpringBoot项目中直接使用java.time.LocalDateTime作为接口返回值时，很可能会遇到这样的报错：

code复制Could not write JSON: Java 8 date/time type `java.time.LocalDateTime` not supported by default

这个问题的根源在于SpringBoot默认使用的Jackson库对Java 8日期类型的支持需要额外配置。Jackson是在Java 8发布之前就存在的库，其核心模块没有原生支持java.time包下的新日期API。

在实际项目中，我遇到过多次前端同事抱怨日期字段显示为[2023,5,15,14,30]这样的数组形式，或者后端接收到的日期参数无法正确绑定。这些问题都源于序列化/反序列化的不兼容。

关键点：SpringBoot 2.x版本虽然已经内置了Jackson 2.9+，但仍需要显式配置才能支持Java 8日期类型

2. 解决方案对比：四种处理方式及其适用场景

2.1 方案一：全局配置Jackson模块（推荐）

这是最彻底的解决方案，通过在application.properties中添加：

properties复制spring.jackson.serialization.write-dates-as-timestamps=false
spring.jackson.date-format=yyyy-MM-dd HH:mm:ss
spring.jackson.time-zone=GMT+8

同时需要在项目中添加Jackson的Java 8日期支持模块依赖：

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

这种方式的优势在于：

1. 全局生效，无需在每个实体类上单独注解
2. 统一了日期格式，避免不同接口返回不同格式
3. 支持时区配置，适合国际化项目

2.2 方案二：使用@JsonFormat注解

在实体类的日期字段上添加注解：

java复制@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private LocalDateTime createTime;

这种方式适合：

• 需要不同字段使用不同格式的场景
• 遗留项目中的局部修改
• 某些字段需要特殊格式（如只显示日期部分）

但缺点也很明显：

1. 需要在每个日期字段上重复配置
2. 容易造成项目中的日期格式不统一
3. 维护成本高，修改格式时需要改动多处

2.3 方案三：自定义Jackson配置类

创建配置类实现更灵活的定制：

java复制@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        mapper.reg