已为ObjectMapper设置UTC时区，XMLGregorianCalendar转时间戳仍偏差怎么办？

问题原因 #

你为ObjectMapper设置的UTC时区仅作用于Jackson的序列化/反序列化流程，问题实际出在XML解析阶段：
XML中的<Birthday>1994-11-30</Birthday>属于不带时区信息的纯日期值，JAXB（或你使用的XML解析框架）解析这类值时，默认会采用JVM运行环境的默认时区构造XMLGregorianCalendar对象。如果你的JVM时区为UTC+3，那么解析出来的日期本质是1994-11-30 00:00:00 UTC+3，转成UTC时间就是前一天的21点，对应的时间戳就是你拿到的786142800000，这一步在XML转换成NotifyGetDocsRqType对象时就已经确定，后续Jackson序列化时的时区配置无法修正已经生成的错误时间值。

解决方案 #

方案1：自定义XML日期解析适配器，强制用UTC解析 #

给JAXB编写日期适配器，统一处理无时区的日期解析逻辑，强制使用UTC时区构造XMLGregorianCalendar对象：

1. 编写适配器类：

import javax.xml.bind.annotation.adapters.XmlAdapter;
import javax.xml.datatype.DatatypeConfigurationException;
import javax.xml.datatype.DatatypeFactory;
import javax.xml.datatype.XMLGregorianCalendar;

public class UTCXMLCalendarAdapter extends XmlAdapter<String, XMLGregorianCalendar> {
    private static final DatatypeFactory DATATYPE_FACTORY;
    static {
        try {
            DATATYPE_FACTORY = DatatypeFactory.newInstance();
        } catch (DatatypeConfigurationException e) {
            throw new RuntimeException(e);
        }
    }

    @Override
    public XMLGregorianCalendar unmarshal(String dateStr) throws Exception {
        if (dateStr == null || dateStr.isBlank()) return null;
        // 解析后强制转换为UTC时区
        return DATATYPE_FACTORY.newXMLGregorianCalendar(dateStr).normalizeToTimezone(0);
    }

    @Override
    public String marshal(XMLGregorianCalendar calendar) throws Exception {
        return calendar == null ? null : calendar.toString();
    }
}

2. 在生日字段上绑定适配器：

@XmlElement(name = "Birthday")
@XmlJavaTypeAdapter(UTCXMLCalendarAdapter.class)
protected XMLGregorianCalendar birthday;

如果项目中有大量同类日期字段，可以全局注册该适配器，无需逐个字段加注解。

方案2：自定义Jackson序列化器，序列化时修正时区 #

如果不想修改XML解析逻辑，可以自定义XMLGregorianCalendar类型的序列化规则，序列化时直接取原日期的年月日构造UTC时间：

1. 编写序列化器：

import com.fasterxml.jackson.core.JsonGenerator
import com.fasterxml.jackson.databind.SerializerProvider
import com.fasterxml.jackson.databind.ser.std.StdSerializer
import java.time.ZoneOffset
import java.time.ZonedDateTime
import javax.xml.datatype.XMLGregorianCalendar

class XMLCalendarUTCSerializer : StdSerializer<XMLGregorianCalendar>(XMLGregorianCalendar::class.java) {
    override fun serialize(
        value: XMLGregorianCalendar, 
        gen: JsonGenerator, 
        provider: SerializerProvider
    ) {
        // 直接读取原日期的年月日，构造UTC时区的0点时间
        val utcTime = ZonedDateTime.of(
            value.year, value.month, value.day,
            0, 0, 0, 0, ZoneOffset.UTC
        )
        gen.writeNumber(utcTime.toInstant().toEpochMilli())
    }
}

2. 将序列化器注册到ObjectMapper：

@Bean
fun objectMapper() = ObjectMapper()
    .apply {
        // 保留你原来的所有配置
        val customModule = SimpleModule()
        customModule.addSerializer(XMLGregorianCalendar::class.java, XMLCalendarUTCSerializer())
        registerModule(customModule)
    }

方案3：全局设置JVM默认时区为UTC #

如果你的服务全链路都使用UTC时区，没有其他时区依赖，可以直接在应用启动时设置全局默认时区，从根源解决时区偏移问题：

import org.springframework.boot.autoconfigure.SpringBootApplication
import org.springframework.boot.runApplication
import java.util.TimeZone

@SpringBootApplication
class YourApplication

fun main(args: Array<String>) {
    TimeZone.setDefault(TimeZone.getTimeZone("UTC"))
    runApplication<YourApplication>(*args)
}

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