Spring Boot中Jackson对java.util.Date的映射问题及时区疑惑

核心问题原因拆解 #

1. 为什么时间显示为05:30:00而非00:00:00？ #

java.util.Date本质是无时区的时间戳，它存储的是从1970-01-01 UTC开始的毫秒数，本身不包含时区信息。控制台输出的Date.toString()结果，是JVM用**系统默认时区（这里是IST，UTC+5:30）**将时间戳转换为字符串的结果。

你的场景中，Jackson解析无时区的日期字符串"2024-05-15"时，若默认使用UTC时区解析，会将其视为UTC的2024-05-15 00:00:00，对应的时间戳转换为IST时区时，就会加上5.5小时，得到IST的2024-05-15 05:30:00（你输出中的May 16可能是笔误，或存在其他时区配置冲突）。

2. 为什么Jackson没有按默认UTC处理？ #

Jackson的ObjectMapper默认时区是JVM系统默认时区，而非UTC。只有显式配置时区为UTC后，才会用UTC解析日期。你未做配置时，Jackson会跟随JVM的IST时区解析，若此时解析结果显示为UTC转换后的IST时间，说明你的Jackson可能被隐式配置为UTC（比如依赖的第三方库、Spring Boot的某些自动配置覆盖），或者你混淆了解析时区和显示时区。

解决方案 #

方案一：统一配置Jackson时区和日期格式 #

在Spring Boot中，通过配置文件或代码指定Jackson的时区和格式，确保解析和序列化行为一致：

配置文件方式（application.properties）

# 设置Jackson时区为UTC
spring.jackson.time-zone=UTC
# 指定日期解析/序列化格式
spring.jackson.date-format=yyyy-MM-dd

代码配置方式

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        // 强制使用UTC时区
        mapper.setTimeZone(TimeZone.getTimeZone("UTC"));
        // 统一日期格式
        mapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd"));
        return mapper;
    }
}

方案二：使用Java 8日期API（推荐） #

java.util.Date是过时API，建议改用java.time.LocalDate（仅存日期，无时间/时区），配合Jackson的JSR310模块（Spring Boot默认集成），彻底避免时区混淆：

修改实体类：

import java.time.LocalDate;

public class SampleClass {
    Integer num1;
    LocalDate receivedDate;

    // getters and setters
}

此时"2024-05-15"会直接映射为LocalDate.of(2024,5,15)，toString()输出就是2024-05-15，无时区转换问题。

方案三：为单个Date字段添加注解 #

若必须保留java.util.Date，可通过@JsonFormat注解指定字段的解析格式和时区：

import com.fasterxml.jackson.annotation.JsonFormat;
import java.util.Date;

public class SampleClass {
    Integer num1;
    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd", timezone = "UTC")
    Date receivedDate;

    // getters and setters
}

该注解会强制Jackson用UTC时区解析日期字符串，避免系统时区干扰。

内容的提问来源于stack exchange，提问作者Alok Kumar