mybatis二级缓存要求实体类实现serializable接口，是因为其跨sqlsession、跨线程甚至跨jvm的共享特性，启用flushinterval、淘汰策略或集成redis等外部缓存时必须序列化；而一级缓存仅限单个sqlsession内存，无需序列化。

MyBatis 二级缓存要求实体类实现 Serializable 接口，不是为了“强制校验”，而是由其底层缓存机制和运行时行为决定的——不实现，很可能在运行中抛 NotSerializableException。

为什么二级缓存需要序列化

二级缓存是跨 SqlSession、跨线程甚至跨 JVM 的共享缓存。虽然默认使用 PerpetualCache（基于 HashMap 存引用），但一旦启用以下任一配置，对象就必须可序列化：

• 设置了 flushInterval：MyBatis 会用 ScheduledCache 包装，该装饰器内部会序列化对象做定时清理
• 配置了淘汰策略（如 LruCache）：部分实现会触发深拷贝或状态快照，依赖序列化
• 集成外部缓存（Redis/Ehcache/Caffeine）：数据需跨进程传输，必须序列化
• 开启 useCache="true" 且存在多线程并发读写：MyBatis 缓存装饰链可能隐式调用序列化逻辑

不实现 Serializable 的典型报错场景

常见错误不是启动失败，而是在首次写入缓存或定时刷新时爆发：

Java Maven Code Review

审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

• 日志出现 java.io.NotSerializableException: com.example.User
• 异常堆栈里含 ScheduledCache、SerializedCache 或第三方缓存客户端调用链
• 现象：查询成功一次后，第二次查就卡住或报错，缓存完全失效

实操建议：怎么正确实现

别只图编译通过，要兼顾稳定性与兼容性：

• 所有可能进二级缓存的 POJO，统一 implements Serializable，哪怕只是空接口
• 手写固定 serialVersionUID，例如：private static final long serialVersionUID = 1L;；避免 IDE 自动生成导致类结构微调后反序列化失败
• 若用 Lombok，@Data 不自动加 Serializable，需显式写：public class User implements Serializable { @Data ... }
• 注意嵌套对象：如果实体包含其他自定义对象（如 Address、Role），它们也必须实现 Serializable

一级缓存为什么不需要

一级缓存作用域仅限单个 SqlSession 内存，生命周期短、不跨线程、不持久化，全程用对象引用传递，完全不涉及序列化过程。所以它对 Serializable 零要求。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南