Spring Boot REST接口如何将日期序列化为长整型时间戳
根因定位
独立实例化的ObjectMapper未经过Spring Boot自动配置流程,保留Jackson原生默认行为——将java.util.Date序列化为毫秒级时间戳;而Spring Boot用于处理REST接口请求响应的全局共享ObjectMapper实例,被自动配置类默认关闭了WRITE_DATES_AS_TIMESTAMPS序列化特性,因此时间类型会被序列化为ISO-8601格式的字符串,即实际返回的2021-04-19T23:33:06.065+0000格式。
调整方案
方案1:配置文件快速适配(推荐)
直接修改Spring Boot核心配置文件,无需编写自定义代码,即可全局覆盖默认序列化规则:
- 若使用
application.properties,添加如下配置:
# 开启所有时间类型按毫秒时间戳序列化 spring.jackson.serialization.write-dates-as-timestamps=true # 配套开启反序列化规则,避免入参时间格式解析异常 spring.jackson.deserialization.read-dates-as-timestamps=true
- 若使用
application.yml,添加如下配置:
spring: jackson: serialization: write-dates-as-timestamps: true deserialization: read-dates-as-timestamps: true
方案2:配置类统一定制
如果项目中需要集中管理Jackson的全局规则,可以通过配置类定制ObjectMapper构造逻辑,和配置文件效果完全一致:
@Configuration public class JacksonGlobalConfig { @Bean public Jackson2ObjectMapperBuilderCustomizer jacksonCustomizer() { return builder -> builder.featuresToEnable( SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, DeserializationFeature.READ_DATES_AS_TIMESTAMPS ); } }
方案3:单字段局部控制
如果不需要全局调整规则,仅要求特定时间字段输出时间戳格式,可直接在实体类对应字段上加序列化注解,精确控制输出行为:
public class MyObj { // 强制该字段序列化为数字类型的毫秒时间戳 @JsonFormat(shape = JsonFormat.Shape.NUMBER) private Date lastUpdatedAt; }
注意事项
- 若项目中存在自定义
WebMvcConfigurer实现,手动替换了Spring MVC默认JSON消息转换器、自行实例化ObjectMapper对象,上述全局配置不会生效,需手动在自定义的ObjectMapper实例上开启对应序列化特性。 - 上述配置对Jackson支持的所有时间类型(包括
java.util.Date、java.time.Instant、java.time.LocalDateTime等)统一生效,无需为每个时间类型单独配置规则。
内容的提问来源于stack exchange,提问作者yalkris
相关产品推荐
相关产品推荐

