Spring返回JSON时客户端时间偏移问题及原因疑惑

问题描述 #

我有一个包含日期字段的实体类：

import java.util.Date;
...

@Basic(optional = false)
@Column(name = "ora_programare")
@Temporal(TemporalType.TIMESTAMP)
private Date oraProgramare;

在Rest控制器处理入口的函数末尾打印该字段值，显示为：

oraProgramare=2023-08-01 08:30:00.0

但在POSTMAN中收到的响应日期却偏移了3小时30分钟：

"oraProgramare": "2023-08-01T05:00:00.000+00:00"

原因分析 #

虽然通过ZoneId.systemDefault()确认了系统默认时区是Europe/Bucharest，但Spring默认使用Jackson进行JSON序列化时，java.util.Date类型的字段会被默认序列化为UTC时区的时间格式（即+00:00时区）——这是Jackson的默认配置规则，它不会自动沿用系统默认时区处理日期序列化。

通过@JsonFormat(pattern = "yyyy-MM-dd hh:mm:ss",timezone="Europe/Bucharest")注解能解决单个字段的问题，但逐个字段添加注解确实繁琐。

解决方案 #

1. 全局配置Jackson时区 #

可以在Spring配置中统一设置Jackson的序列化时区，避免逐个字段添加注解：

• Spring Boot项目（配置文件方式）：在application.properties或application.yml中添加配置：

  # application.properties
  spring.jackson.time-zone=Europe/Bucharest
  spring.jackson.date-format=yyyy-MM-dd HH:mm:ss
  

• Java代码配置方式：编写配置类统一配置ObjectMapper：

  import com.fasterxml.jackson.databind.ObjectMapper;
  import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
  import org.springframework.context.annotation.Bean;
  import org.springframework.context.annotation.Configuration;
  import java.util.TimeZone;
  import java.time.ZoneId;
  
  @Configuration
  public class JacksonConfig {
      @Bean
      public ObjectMapper objectMapper() {
          ObjectMapper objectMapper = new ObjectMapper();
          objectMapper.setTimeZone(TimeZone.getTimeZone(ZoneId.of("Europe/Bucharest")));
          // 适配Java 8+时间API需注册模块
          objectMapper.registerModule(new JavaTimeModule());
          return objectMapper;
      }
  }
  

2. 改用Java 8+时间API（LocalDateTime） #

java.util.Date是旧版日期API，存在线程不安全、设计冗余等问题，推荐改用java.time.LocalDateTime（存储本地时间，无时区偏移问题）：

• 修改实体类字段：

  import java.time.LocalDateTime;
  ...
  
  @Basic(optional = false)
  @Column(name = "ora_programare")
  private LocalDateTime oraProgramare;
  

  结合全局配置的Jackson时区，序列化时会直接使用指定时区生成正确格式的时间，无需额外注解。注意：JPA 2.2及以上版本默认支持Java 8时间API，旧版本需添加hibernate-java8依赖适配。

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