Java Spring Boot中如何正确处理带偏移的DateTime映射？

前端通过POST请求传入带偏移的时间字符串，示例为2024-04-12T10:39:23+02:00。在Java Spring Boot后端需要映射该时间并保留偏移信息，最初尝试用ZonedDateTime对象，映射后得到2024-04-12T08:39:23[UTC]，偏移被错误转为UTC；后续改用OffsetDateTime仍存在问题。请问为何无法正确处理偏移？有哪些解决方案？

附后端POST映射代码：

@PostMapping(value = "/test",
        produces = MediaType.TEXT_PLAIN_VALUE)
@ResponseStatus(HttpStatus.OK)
public String test(
        @Valid
        @RequestBody
        TestObject test) {
    return "OK";
}

TestObject实体类代码：

package blabla;

import lombok.Getter;
import lombok.Setter;

import java.time.OffsetDateTime;

@Getter
@Setter
public class TestObject {
    private OffsetDateTime date;
}

核心原因是Spring Boot默认的Jackson序列化/反序列化配置会自动将时区转换为UTC，而非保留原始传入的偏移信息。Jackson处理Java 8时间类（如ZonedDateTime、OffsetDateTime）时，默认开启WRITE_DATES_AS_TIMESTAMPS，且时区默认设为UTC，导致反序列化过程中丢失原始偏移。

方案1：全局配置Jackson，禁用UTC转换并保留偏移 #

在application.yml中添加配置：

spring:
  jackson:
    deserialization:
      ADJUST_DATES_TO_CONTEXT_TIME_ZONE: false
    serialization:
      WRITE_DATES_WITH_ZONE_ID: true

或通过Java配置类自定义ObjectMapper：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
import com.fasterxml.jackson.datatype.jsr310.deser.OffsetDateTimeDeserializer;
import com.fasterxml.jackson.datatype.jsr310.ser.OffsetDateTimeSerializer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.time.OffsetDateTime;
import java.time.format.DateTimeFormatter;

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        JavaTimeModule timeModule = new JavaTimeModule();
        
        DateTimeFormatter formatter = DateTimeFormatter.ISO_OFFSET_DATE_TIME;
        timeModule.addSerializer(OffsetDateTime.class, new OffsetDateTimeSerializer(formatter));
        timeModule.addDeserializer(OffsetDateTime.class, new OffsetDateTimeDeserializer(formatter));
        
        mapper.registerModule(timeModule);
        mapper.configure(com.fasterxml.jackson.databind.DeserializationFeature.ADJUST_DATES_TO_CONTEXT_TIME_ZONE, false);
        return mapper;
    }
}

方案2：字段级注解单独配置 #

在TestObject的date字段上添加@JsonFormat注解，指定格式并保留原始偏移：

@Getter
@Setter
public class TestObject {
    @JsonFormat(pattern = "yyyy-MM-dd'T'HH:mm:ssXXX", timezone = JsonFormat.DEFAULT_TIMEZONE)
    private OffsetDateTime date;
}

其中XXX匹配偏移格式（如+02:00），JsonFormat.DEFAULT_TIMEZONE会保留传入的原始时区偏移，不强制转换为默认时区。

方案3：自定义Spring转换器 #

添加字符串到OffsetDateTime的自定义转换器，直接按标准格式解析：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.convert.converter.Converter;
import java.time.OffsetDateTime;
import java.time.format.DateTimeFormatter;

@Configuration
public class DateTimeConverterConfig {
    @Bean
    public Converter<String, OffsetDateTime> stringToOffsetDateTimeConverter() {
        return source -> OffsetDateTime.parse(source, DateTimeFormatter.ISO_OFFSET_DATE_TIME);
    }
}

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