Mongo存储LocalDate时为何减1小时？相关时区问题排查

核心问题拆解 #

1. @JsonFormat的作用边界：这个注解只负责Jackson处理JSON和Java对象之间的转换（也就是REST接口的请求/响应环节），完全不影响Spring Data MongoDB对数据的持久化逻辑——这就是你配置了timezone="UTC"但Mongo存储依然偏移的原因。
2. Mongo存储的时区偏差：你看到的ISODate('1969-12-31T23:00:00.000Z')，是因为Spring Data MongoDB默认使用JVM的默认时区（Europe/London）将Java时间对象转换为UTC存储。虽然你处于英国冬季（GMT/UTC一致），但JVM的Europe/London时区包含夏令时配置，可能在解析或转换时触发了错误的时区计算逻辑。

针对性解决方案 #

1. 强制Spring Data MongoDB用UTC持久化时间 #

这是解决存储时区偏差的关键，有两种配置方式：

方式一：配置文件直接指定

在application.properties中添加：

spring.data.mongodb.timezone=UTC

或application.yml中：

spring:
  data:
    mongodb:
      timezone: UTC

方式二：自定义Mongo转换规则

如果需要更精细的控制，可以注册自定义转换类：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.mongodb.core.convert.MongoCustomConversions;
import org.springframework.data.mongodb.core.convert.DateToStringConverter;
import org.springframework.data.mongodb.core.convert.StringToDateConverter;

import java.time.ZoneId;
import java.util.Arrays;

@Configuration
public class MongoConfig {

    @Bean
    public MongoCustomConversions mongoCustomConversions() {
        return new MongoCustomConversions(Arrays.asList(
                DateToStringConverter.INSTANCE.withTimeZone(ZoneId.of("UTC")),
                StringToDateConverter.INSTANCE.withTimeZone(ZoneId.of("UTC"))
        ));
    }
}

2. 推荐使用LocalDate字段类型 #

如果你的enrollmentDate只需要日期（不需要时分秒），直接用java.time.LocalDate类型更稳妥——它本身不带时区信息，Spring Data MongoDB会默认将其存储为UTC时区的当天午夜（ISODate('1970-01-01T00:00:00.000Z')），同时配合@JsonFormat可以保证JSON解析/序列化的正确性：

import com.fasterxml.jackson.annotation.JsonFormat;
import org.springframework.data.mongodb.core.mapping.Field;

public record Enrollment(
    @Field("enrollment_date")
    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "dd-MM-yyyy", timezone = "UTC")
    LocalDate enrollmentDate
) {}

3. 修正JVM时区配置（可选） #

如果JVM时区仍存在异常，可以在启动时强制指定UTC：

# 启动JVM时添加参数
-Duser.timezone=UTC

或在代码全局设置（不推荐，会影响所有时间处理）：

TimeZone.setDefault(TimeZone.getTimeZone("UTC"));

验证方法 #

配置完成后重新发送"enrollmentDate": "01-01-1970"的请求，再用Mongo Shell查看，enrollment_date应显示为ISODate('1970-01-01T00:00:00.000Z')，同时GET请求依然返回正确的"01-01-1970"。

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