java 对象序列化中处理日期类型,最稳妥的做法是将 date 或 localdatetime 转换为字符串(如 iso-86421 格式)或时间戳(long)进行存储。直接序列化 java.util.date 依赖 jdk 默认实现,存在版本兼容性问题;而使用 jackson 等现代库时,需通过注解或全局配置指定序列化策略,以避免出现毫秒数丢失或时区错误。

JDK 原生序列化如何处理 Date 字段
JDK 原生的 ObjectOutputStream 在处理 java.util.Date 时,会将其转换为自纪元以来的毫秒数(long)进行存储,并在反序列化时重建为 Date 对象。这种机制虽然简单,但要求序列化和反序列化端的 JDK 版本一致,且无法自定义格式。若类中同时包含 Date 和 LocalDateTime,后者在 JDK 8+ 中默认不被支持,会抛出异常,除非显式实现 Externalizable 接口。

import java.io.*;
import java.util.Date;
public class DateSerializationDemo implements Serializable {
private static final long serialVersionUID = 1L;
private Date legacyDate;
// private LocalDateTime modernDate; // JDK 原生不支持,会报错
public DateSerializationDemo(Date date) {
this.legacyDate = date;
}
public static void main(String[] args) throws Exception {
Date now = new Date();
// 序列化
FileOutputStream fos = new FileOutputStream("date.ser");
ObjectOutputStream oos = new ObjectOutputStream(fos);
oos.writeObject(new DateSerializationDemo(now));
oos.close();
// 反序列化
FileInputStream fis = new FileInputStream("date.ser");
ObjectInputStream ois = new ObjectInputStream(fis);
DateSerializationDemo obj = (DateSerializationDemo) ois.readObject();
System.out.println("Deserialized: " + obj.legacyDate);
ois.close();
}
}
上述代码展示了 JDK 原生序列化的基本流程。运行后,控制台会输出反序列化后的日期时间。注意,如果尝试取消注释 modernDate 字段并赋值,程序在序列化时会抛出 NotSerializableException,因为 LocalDateTime 未实现 Serializable 接口。这证明了 JDK 原生方式对现代日期类型的局限性。
Jackson 库如何配置日期序列化
在使用 Jackson 进行 JSON 序列化时,默认行为是将 Date 序列化为毫秒时间戳,将 LocalDateTime 序列化为数组(年、月、日等)。为了获得可读性更强的 ISO-8601 字符串格式,需要引入 jackson-datatype-jsr310 模块并注册 JavaTimeModule。此外,可以通过 @JsonFormat 注解精确控制单个字段的格式与时区。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
import com.fasterxml.jackson.annotation.JsonFormat;
import java.time.LocalDateTime;
import java.util.Date;
public class JacksonDateDemo {
public static class User {
public Date createdTime;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
public LocalDateTime localJoinTime;
}
public static void main(String[] args) throws Exception {
ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(new JavaTimeModule());
User user = new User();
user.createdTime = new Date();
user.localJoinTime = LocalDateTime.now();
String json = mapper.writeValueAsString(user);
System.out.println(json);
}
}
运行该代码,输出的 JSON 中 createdTime 仍为数字(毫秒),而 localJoinTime 则变为类似 "2023-10-27 10:00:00" 的字符串。这是因为 JavaTimeModule 专门处理 JSR-310 类型,而 @JsonFormat 覆盖了默认行为。若不注册模块,localJoinTime 将被序列化为数组,导致前端解析困难。
时区设置对序列化结果的具体影响
当使用 Jackson 序列化 Date 或 LocalDateTime 时,时区设置直接决定最终输出的文本内容。Date 内部存储的是 UTC 时间戳,但在序列化为字符串时,若未指定时区,通常使用 JVM 默认时区。对于 LocalDateTime,它本身不包含时区信息,因此序列化时必须依赖配置的时区上下文。若服务器位于 GMT+8,而客户端期望 GMT+0,未正确配置会导致时间偏差 8 小时。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










