redisson 默认使用 kryo 实现高效序列化，而非 java 原生序列化；无需强制实现 `serializable`，但需确保类型可被 kryo 正确处理，且支持自定义序列化器以适配复杂场景。
在基于 JCache（JSR-107）规范集成 Redisson 作为缓存提供者时，序列化机制是影响性能、兼容性与可维护性的关键环节。虽然 Redisson 的 JCache 实现对外封装良好，开发者无需显式配置即可开箱即用，但其底层序列化行为并非“透明黑盒”——理解它对避免运行时异常、优化存储效率及支持自定义类型至关重要。
默认序列化器：Kryo 而非 Java 原生序列化
Redisson 默认采用 Kryo（v5+ 版本默认为 Kryo 5.x）作为序列化引擎，而非 Java 的 ObjectOutputStream/ObjectInputStream。这意味着：
- ✅ 不强制要求缓存对象实现 java.io.Serializable（尽管部分旧版 Kryo 配置可能依赖它）；
- ✅ 对 java.time.* 类型（如 LocalDateTime、ZonedDateTime）、集合（List、Map）、POJO 等常见类型有开箱即用的支持；
- ✅ 序列化后数据体积更小、速度更快，且不依赖类的 serialVersionUID 或反射构造器可见性；
- ❌ Redis 中存储的是二进制字节流（非可读 JSON 或字符串），直接 GET 键值将看到乱码——这正印证了 Kryo 的紧凑二进制格式，而非 Java 原生序列化的 AC ED 00 05 标识头。
可通过以下代码验证当前序列化器类型：
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
Config config = new Config();
config.useSingleServer().setAddress("redis://127.0.0.1:6379");
RedissonClient redisson = Redisson.create(config);
// 检查实际使用的编解码器（JCache 封装层下仍由 Redisson Codec 控制）
Codec codec = ((Redisson) redisson).getCodec(); // 如 Codec = new Kryo5Codec()是否需要实现 Serializable？
不需要，也不推荐仅为此实现。
Kryo 默认不检查 Serializable 接口。若强行要求实现，反而可能掩盖类型注册缺失问题（例如未注册自定义类），或导致误用 Java 原生序列化路径。真正关键的是：
- 所有缓存对象及其嵌套字段类型，必须能被 Kryo 无参构造 + 字段直写方式序列化（Kryo 默认策略）；
- 对于无默认构造器、含 final 字段、或使用 Lombok @RequiredArgsConstructor 的类，需显式注册自定义 Serializer 或启用 setRegistrationRequired(false)（不推荐用于生产，会降低安全性与性能）。
自定义序列化行为（推荐做法）
当默认 Kryo 无法满足需求（如需兼容遗留系统、审计日志可读性、或特殊类型如 ByteBuffer）时，可通过 Codec 替换：
// 使用 JSON（Jackson）实现可读、跨语言兼容的序列化
Codec codec = new JsonJacksonCodec();
Config config = new Config();
config.setCodec(codec); // 全局生效
config.useSingleServer().setAddress("redis://127.0.0.1:6379");
RedissonClient redisson = Redisson.create(config);
CacheManager cacheManager = Caching.getCachingProvider()
.getCacheManager(new URI("redis://127.0.0.1:6379"), config);⚠️ 注意：JSON 序列化会带来额外 CPU 开销与体积膨胀，且 java.time.* 需配合 JavaTimeModule 注册：ObjectMapper mapper = new ObjectMapper(); mapper.registerModule(new JavaTimeModule()); Codec codec = new JsonJacksonCodec(mapper);
最佳实践总结
- 优先信任默认 Kryo：对标准 JDK 类型和常规 POJO 已高度优化，无需干预；
- 避免 Serializable 陷阱：不要仅为适配缓存而修改领域模型接口；
- 自定义类型务必注册：使用 Kryo5Codec 时，通过 Kryo5Codec.Builder 注册自定义类或 Serializer；
- 生产环境禁用 setRegistrationRequired(false)：防止反序列化任意类引发安全风险（如远程代码执行）；
- 监控序列化失败：捕获 org.redisson.client.RedisException 及嵌套的 com.esotericsoftware.kryo.KryoException，及时定位未注册类型。
理解并合理利用 Redisson 的序列化机制，不仅能规避 NotSerializableException 或 KryoException，更能为缓存架构打下高性能、高可靠的基础。
