Java Timestamp异常问题：Spring JSON传输日期字段值不符

嘿，我之前也踩过这个一模一样的坑！Spring默认用Jackson处理JSON序列化/反序列化，Date类型字段特别容易因为配置不当出现值错误的情况，尤其是时区或者格式不匹配的问题。结合你的场景，给你几个靠谱的解决方案：

1. 全局统一配置Jackson的日期格式与时区 #

如果想让整个应用的Date字段都用统一规则处理，推荐在配置文件里做全局设置：

• Spring Boot项目：在application.properties里添加：

  # 指定日期格式，可根据业务调整
  spring.jackson.date-format=yyyy-MM-dd HH:mm:ss
  # 设置时区，比如业务用东八区就填GMT+8，或者UTC
  spring.jackson.time-zone=GMT+8
  

• 传统Spring MVC项目：通过配置类自定义ObjectMapper：

  @Configuration
  public class WebMvcConfig implements WebMvcConfigurer {
      @Bean
      public ObjectMapper objectMapper() {
          ObjectMapper mapper = new ObjectMapper();
          SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
          dateFormat.setTimeZone(TimeZone.getTimeZone("GMT+8"));
          mapper.setDateFormat(dateFormat);
          return mapper;
      }
  }
  

2. 给单个Date字段添加注解定制规则 #

如果只需要针对TransactionParameters里的日期字段单独配置，可以用@JsonFormat注解精准控制：

public class TransactionParameters {
    // 指定格式和时区，按需调整
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    public Date startDate;
    
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    public Date endDate;
    
    public List<String> transactionCodes;
    
    // 补上你的getter/setter方法
}

3. 检查前端传输的JSON格式是否匹配 #

很多时候错误根源是前后端格式不兼容：

• 如果前端传字符串日期，要确保格式和后端配置一致（比如后端用yyyy-MM-dd，前端就不能传MM/dd/yyyy）；
• 如果前端传时间戳，要确认是毫秒级还是秒级：Jackson默认解析毫秒级时间戳，如果前端传的是秒级，解析后会变成1970年左右的错误日期，这时候可以在注解里加shape = JsonFormat.Shape.NUMBER_INT，或者全局配置支持秒级时间戳。

4. 升级到Java 8日期API（推荐方案） #

旧的Date类本身设计缺陷很多，建议换成Java 8的LocalDate/LocalDateTime等新API，配合Jackson的jackson-datatype-jsr310模块（Spring Boot已默认引入），处理日期更直观，时区问题也更容易控制：

import java.time.LocalDateTime;
import com.fasterxml.jackson.annotation.JsonFormat;

public class TransactionParameters {
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    public LocalDateTime startDate;
    
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    public LocalDateTime endDate;
    
    public List<String> transactionCodes;
    
    // getter/setter方法
}

最后提醒一句：时区是最容易忽略的细节！比如服务器用UTC时区，而你的业务是东八区时间，就会出现日期差8小时的情况，一定要确认前后端的时区配置一致哦。

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