如何通过默认配置将浮点型时间戳反序列化为LocalDateTime？

算力阿峰

2026-8-21

解决浮点型时间戳转LocalDateTime的反序列化错误

错误原因

JavaTimeModule默认的LocalDateTime反序列化器不支持浮点数字输入，它仅接受ISO格式字符串、日期分量数组或长整型数字，因此遇到浮点型时间戳时会抛出类型不匹配异常。

解决方案（无需自定义反序列化器）

方案1：用Instant接收时间戳，再转换为LocalDateTime

Instant的内置反序列化器支持解析浮点型时间戳（将数值视为从1970-01-01T00:00:00Z开始的秒数，小数部分对应纳秒），之后可通过时区转换为LocalDateTime。

修改DTO类：

@Data
@JsonIgnoreProperties(ignoreUnknown = true)
public class Dto {
    @JsonFormat(shape = JsonFormat.Shape.NUMBER_FLOAT)
    private Instant timestamp;

    // 根据业务需求指定时区，示例用系统默认时区
    public LocalDateTime getDate() {
        return timestamp.atZone(ZoneId.systemDefault()).toLocalDateTime();
    }
}

反序列化代码保持不变：

ObjectMapper mapper = new ObjectMapper().registerModule(new JavaTimeModule());
var dto = mapper.readValue(json, Dto.class);

方案2：配置ObjectMapper并调整字段注解

如果必须在DTO中直接保留LocalDateTime字段，可通过指定内置的InstantDeserializer，并配置时区完成转换：

修改DTO类：

@Data
@JsonIgnoreProperties(ignoreUnknown = true)
public class Dto {
    @JsonDeserialize(using = InstantDeserializer.class)
    private LocalDateTime date;
}

调整ObjectMapper配置（指定时区，确保转换正确）：

ObjectMapper mapper = new ObjectMapper()
        .registerModule(new JavaTimeModule())
        .setTimeZone(TimeZone.getDefault());
var dto = mapper.readValue(json, Dto.class);