Spring Boot+MyBatis环境下Java Date字段始终显示前一天求助

问题根源 #

你的问题核心是时区转换不一致：

• Oracle数据库的TIMESTAMP字段不带时区，DBTIMEZONE为+00:00（UTC），存储的是UTC时间2023-05-22 23:00。
• SQL Developer会自动用你的客户端时区（比如BST+01:00）转换显示，所以看到的是2023-05-23 00:00（即UTC+1的时间）。
• Java的java.util.Date本质是UTC时间戳，MyBatis读取Oracle的TIMESTAMP时，直接按UTC解析成Date对象。
• Spring Boot的Jackson默认用UTC时区格式化Date，所以API返回的是2023-05-22T23:00:00.000+0000，和SQL Developer显示的是同一个时间点，只是时区不同。

解决方案 #

方案1：配置Jackson使用指定时区格式化 #

直接修改Spring Boot配置，让API返回的日期使用你需要的时区（比如BST对应Europe/London）：
在application.properties中添加：

spring.jackson.time-zone=Europe/London

或者application.yml：

spring:
  jackson:
    time-zone: Europe/London

配置后，API返回的dueDate会显示为2023-05-23T00:00:00.000+0100，符合预期。

方案2：改用Java 8带时区的日期类型（推荐） #

放弃java.util.Date，使用Java 8的ZonedDateTime或LocalDateTime，从根源避免时区混乱：

1. 修改实体类字段：

private final ZonedDateTime dueDate;

2. MyBatis映射文件无需额外修改（MyBatis 3.4+原生支持Java 8日期类型）：

<result column="D_DUE_DT" jdbcType="TIMESTAMP" property="dueDate" />

3. 可以在字段上用@JsonFormat指定格式化规则及时区：

@JsonFormat(pattern = "yyyy-MM-dd'T'HH:mm:ss.SSSXXX", timezone = "Europe/London")
private final ZonedDateTime dueDate;

方案3：调整数据库字段类型 #

如果业务需要明确存储时区信息，建议将Oracle的字段类型改为TIMESTAMP WITH TIME ZONE，这样数据库会同时存储时间和时区，读取时MyBatis可以直接映射到ZonedDateTime，彻底消除时区歧义。

验证步骤 #

1. 先确认数据库存储的实际UTC时间：
   执行SQL：

SELECT D_DUE_DT AT TIME ZONE 'UTC' FROM your_table;

如果返回2023-05-22 23:00:00，说明存储的时间和API返回的是同一个时间点，只是显示时区不同。
2. 配置完成后重启Spring Boot服务，调用API验证返回的dueDate是否符合预期。

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