Oops! 更改field的数据类型,影响到rabbitmq消费了...(有关于Java序列化)

程序中有如下entity类-LevyPaymentFlow

java 复制代码
@Data
@TableName(value = "levy_payment_flow", autoResultMap = true)
public class LevyPaymentFlow implements Serializable {
    private static final long serialVersionUID = 1L;

    @TableId(type = IdType.AUTO)
    private String flowNo;

    /**
     * 状态:初始、付款中、付款成功、付款失败
     * @see c.e.c.enums.LevyPaymentFlowStatusEnum
     */
    private String status;

    ...
}

为了让代码更易读、易维护,我将其status的类型从String改成对应的枚举 LevyPaymentFlowStatusEnum ,相关的业务代码跟着一并更改。

以我的经验,这个小重构万无一失。

结果上线过程中翻车,现实给我上了一课。

什么问题呢? rabbitmq消费受到影响了。

业务程序中rabbitmq生产消息,将 LevyPaymentFlow 对象直接写入到消息队列中。

上线后的一刻,rabbitmq消费者监听并消费的时候出现异常:ClassCastException: cannot assign instance of java.lang.String to field c.e.c.levypay.entity.LevyPaymentFlow.status of type c.e.c.enums.LevyPaymentFlowStatusEnum in instance of c.e.c.levypay.entity.LevyPaymentFlow(不能将String串赋值给LevyPaymentFlow对象的LevyPaymentFlowStatusEnum类型的status,或者说,不能将String串分配到LevyPaymentFlowStatusEnum类型的LevyPaymentFlow#status上)

这是 java反序列化失败导致的异常。

Java反序列化对象时,当类结构发生变更时,会报上面的 ClassCastException。我们常用的fastjson则可以兼容这个结构的变更,可以兼容本案中的将String串赋值给枚举field的场景。

关于Java序列化,我本地测试来复现一下这个bug

第一步,执行下面test代码,将 LevyPaymentFlow 对象序列化为字节流并保存到文件中。

java 复制代码
FileOutputStream byteArrayOutputStream=new FileOutputStream("testJavaSerialize");
	ObjectOutputStream objectOutputStream=new ObjectOutputStream(byteArrayOutputStream);
	LevyPaymentFlow entity = new LevyPaymentFlow();
	entity.setStatus(LevyPaymentFlowStatusEnum.PAY_SUCCESS.getCode());
	objectOutputStream.writeObject(entity);

第二步,变更 LevyPaymentFlow#status 的类型,改为 LevyPaymentFlowStatusEnum。

第三步,下面代码从上面创建的文件中读取字节流并将其反序列化为 LevyPaymentFlow 对象。执行程序抛出 ClassCastException。

java 复制代码
ObjectInputStream objectInputStream=new ObjectInputStream(new FileInputStream("testJavaSerialize"));
	LevyPaymentFlow entity2= (LevyPaymentFlow)objectInputStream.readObject();

异常堆栈:

java 复制代码
Exception in thread "main" java.lang.ClassCastException: cannot assign instance of java.lang.String to field c.e.c.levypay.entity.LevyPaymentFlow.status of type c.e.c.enums.LevyPaymentFlowStatusEnum in instance of c.e.c.levypay.entity.LevyPaymentFlow
	at java.io.ObjectStreamClass$FieldReflector.setObjFieldValues(ObjectStreamClass.java:2301)
	at java.io.ObjectStreamClass.setObjFieldValues(ObjectStreamClass.java:1431)
	at java.io.ObjectInputStream.defaultReadFields(ObjectInputStream.java:2437)
	at java.io.ObjectInputStream.readSerialData(ObjectInputStream.java:2355)
	at java.io.ObjectInputStream.readOrdinaryObject(ObjectInputStream.java:2213)
	at java.io.ObjectInputStream.readObject0(ObjectInputStream.java:1669)
	at java.io.ObjectInputStream.readObject(ObjectInputStream.java:503)
	at java.io.ObjectInputStream.readObject(ObjectInputStream.java:461)
	at TestMain.main(TestMain.java:82)

关于Java序列化。补充两点,

一)要使用Java序列化,对象类必须实现java.io.Serializable 接口。否则,上面第一步的序列化代码会报错

java 复制代码
Exception in thread "main" java.io.NotSerializableException: c.e.c.levypay.entity.LevyPaymentFlow
	at java.io.ObjectOutputStream.writeObject0(ObjectOutputStream.java:1184)
	at java.io.ObjectOutputStream.writeObject(ObjectOutputStream.java:348)
	at TestMain.main(TestMain.java:75)

二)关于序列化机制中的 serialVersionUID

serialVersionUID 是一个 private static final long 类型的常量,存在于实现了 java.io.Serializable 接口的类中。它作为类的一个版本标识,用于在序列化和反序列化过程中验证序列化对象和类的版本一致性。如果不手动指定 serialVersionUID,JVM 在序列化时会根据类的结构信息自动计算并生成一个 serialVersionUID 值。

如果未指定serialVersionUID,那么,当类的结构发生变更,反序列化时会因serialVersionUID值不同而抛出 InvalidClassException

java 复制代码
Exception in thread "main" java.io.InvalidClassException: c.e.c.levypay.entity.LevyPaymentFlow; local class incompatible: stream classdesc serialVersionUID = -7534543191229157756, local class serialVersionUID = -9139150564353461074
	at java.io.ObjectStreamClass.initNonProxy(ObjectStreamClass.java:699)
	at java.io.ObjectInputStream.readNonProxyDesc(ObjectInputStream.java:2005)
	at java.io.ObjectInputStream.readClassDesc(ObjectInputStream.java:1852)
	at java.io.ObjectInputStream.readOrdinaryObject(ObjectInputStream.java:2186)
	at java.io.ObjectInputStream.readObject0(ObjectInputStream.java:1669)
	at java.io.ObjectInputStream.readObject(ObjectInputStream.java:503)
	at java.io.ObjectInputStream.readObject(ObjectInputStream.java:461)
	at TestMain.main(TestMain.java:80)
相关推荐
二哈赛车手1 天前
新人笔记---ApiFox的一些常见使用出错
java·笔记·spring
为何创造硅基生物1 天前
C语言 结构体内存对齐规则(通俗易懂版)
c语言·开发语言
吃好睡好便好1 天前
在Matlab中绘制横直方图
开发语言·学习·算法·matlab
栗子~~1 天前
JAVA - 二层缓存设计(本地缓冲+redis缓冲+广播所有本地缓冲失效) demo
java·redis·缓存
星寂樱易李1 天前
iperf3 + Python-- 网络带宽、网速、网络稳定性
开发语言·网络·python
YDS8291 天前
DeepSeek RAG&MCP + Agent智能体项目 —— RAG知识库的搭建和接口实现
java·ai·springboot·agent·rag·deepseek
仰泳之鹅1 天前
【C语言】自定义数据类型2——联合体与枚举
c语言·开发语言·算法
之歆1 天前
DAY_12JavaScript DOM 完全指南(二):实战与性能篇
开发语言·前端·javascript·ecmascript
未若君雅裁1 天前
MyBatis 一级缓存、二级缓存与清理机制
java·缓存·mybatis
cen__y1 天前
Linux12(Git01)
linux·运维·服务器·c语言·开发语言·git