MyBatis-Plus 实体类继承与序列化接口的实现问题解析

问题背景

在使用 MyBatis-Plus 代码生成器(版本3.5.2)时，开发者发现当实体类继承自定义父类时，生成的代码不会自动实现序列化接口(Serializable)，而不继承父类时则会正常实现该接口。

技术分析

序列化接口的重要性

在Java中，Serializable接口是一个标记接口，用于标识类的对象可以被序列化。对于MyBatis-Plus实体类来说，实现序列化接口有几个重要原因：

1. 缓存需求：许多缓存框架(如Redis)要求存储的对象必须可序列化
2. 网络传输：在分布式系统中，实体对象可能需要跨网络传输
3. 持久化存储：某些情况下需要将对象状态持久化到文件或数据库中

MyBatis-Plus的设计考量

MyBatis-Plus代码生成器默认在父类上实现序列化接口，而不是在子类上实现，这是有合理设计考虑的：

1. 避免反序列化问题：如果父子类都实现序列化接口，可能会导致反序列化时的混乱
2. 统一管理：将序列化能力放在父类中可以统一管理所有子类的序列化行为
3. DRY原则：避免在每个子类中重复实现相同的接口

解决方案

方案一：在父类中实现序列化接口

最佳实践是在自定义的父类中实现Serializable接口，这样所有继承该父类的实体类都会自动具备序列化能力：

public class BaseEntity implements Serializable {
    private static final long serialVersionUID = 1L;
    // 其他公共字段和方法
}

方案二：自定义代码生成模板

如果需要改变默认行为，可以通过修改代码生成模板来实现：

1. 找到MyBatis-Plus的代码生成模板文件
2. 修改实体类模板，添加序列化接口的实现逻辑
3. 配置生成器使用自定义模板

实践建议

1. 统一父类设计：建议所有实体类共用的功能(如序列化、公共字段等)都放在父类中实现
2. serialVersionUID：如果实现序列化接口，最好显式声明serialVersionUID字段
3. 谨慎选择：除非有特殊需求，否则建议遵循MyBatis-Plus的默认设计

总结

MyBatis-Plus代码生成器在实体类继承方面的行为是经过深思熟虑的设计选择，旨在避免潜在的序列化问题并保持代码的整洁性。开发者应该理解这一设计背后的考量，并根据项目实际需求选择合适的实现方式。在大多数情况下，将序列化能力放在父类中是更为合理和安全的选择。