Jackson ObjectMapper时区转换失效，无法转为Europe/Amsterdam时区

核心问题分析 #

你的配置未生效主要源于以下几点：

• 依赖TimeZone.getDefault()获取时区，但运行环境的默认时区可能并非Europe/Amsterdam
• 若使用Java 8+的日期类型（如Instant），Jackson默认序列化Instant会强制输出UTC时区（带Z后缀），不受上下文时区设置影响
• 未注册Java 8日期类型支持模块，且未明确配置带时区的日期格式化规则

修复步骤与代码示例 #

1. 显式指定目标时区 #

不要依赖默认时区，直接锁定Europe/Amsterdam时区：

import java.util.TimeZone
import java.time.ZoneId

// 转为TimeZone格式供Jackson使用
TimeZone.getTimeZone(ZoneId.of("Europe/Amsterdam"))

2. 注册必备模块 #

Jackson默认不支持Java 8日期API（Instant、ZonedDateTime等），必须注册JavaTimeModule和KotlinModule（Kotlin项目必备）才能让时区配置生效。

3. 完整修改后的配置 #

import com.fasterxml.jackson.databind.SerializationFeature
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule
import com.fasterxml.jackson.module.kotlin.KotlinModule
import org.springframework.http.converter.json.Jackson2ObjectMapperBuilderCustomizer
import java.time.ZoneId
import java.util.TimeZone

fun objectMapperCustomizer(): Jackson2ObjectMapperBuilderCustomizer {
    return Jackson2ObjectMapperBuilderCustomizer { builder ->
        // 显式设置阿姆斯特丹时区
        val amsterdamZone = ZoneId.of("Europe/Amsterdam")
        builder.timeZone(TimeZone.getTimeZone(amsterdamZone))
        
        // 注册Java 8日期模块与Kotlin模块
        builder.modules(JavaTimeModule(), KotlinModule())
        
        // 禁用时间戳序列化，启用上下文时区序列化
        builder.featuresToDisable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS)
        builder.featuresToEnable(SerializationFeature.WRITE_DATES_WITH_CONTEXT_TIME_ZONE)
        
        // 指定带时区偏移的ISO日期格式
        builder.simpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSXXX")
        
        builder.serializationInclusion(com.fasterxml.jackson.annotation.JsonInclude.Include.NON_NULL)
    }
}

4. 处理Instant类型的特殊情况 #

如果你的日期字段是Instant类型（本身是UTC时间），Jackson默认会输出Z后缀格式。要将其转为阿姆斯特丹时区，可自定义序列化器：

import com.fasterxml.jackson.core.JsonGenerator
import com.fasterxml.jackson.databind.JsonSerializer
import com.fasterxml.jackson.databind.SerializerProvider
import java.time.Instant
import java.time.ZoneId
import java.time.format.DateTimeFormatter

class InstantToAmsterdamSerializer : JsonSerializer<Instant>() {
    private val formatter = DateTimeFormatter.ISO_OFFSET_DATE_TIME.withZone(ZoneId.of("Europe/Amsterdam"))
    
    override fun serialize(value: Instant, gen: JsonGenerator, serializers: SerializerProvider) {
        gen.writeString(formatter.format(value))
    }
}

在配置中注册该序列化器：

builder.serializerByType(Instant::class.java, InstantToAmsterdamSerializer())

验证 #

修改完成后，日期字段将输出符合预期的格式，例如2022-09-12T13:53:10.864+02:00。

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