Redisson的RBucket支持泛型但需显式指定JsonJacksonCodec并配合TypeReference才能正确处理复杂嵌套泛型，否则反序列化会丢失类型信息导致ClassCastException；自定义对象需满足Jackson序列化要求，或封装为POJO提升稳定性。
Redisson 的 RBucket 支持泛型，但底层序列化机制（默认为 FstCodec 或 JsonJacksonCodec）决定了能否正确存取复杂泛型对象——关键不在泛型声明本身，而在序列化器是否能完整保留类型信息。
必须显式指定支持泛型的序列化器
Java 泛型在运行时被擦除，RBucket<Map<String, List<User>>> 这样的复杂嵌套泛型，若用默认序列化器（如 FstCodec），反序列化时可能还原为 LinkedHashMap 和原始 ArrayList，丢失泛型类型信息，导致强转失败。
- 推荐使用
JsonJacksonCodec，它基于 Jackson，能通过TypeReference精确还原嵌套泛型结构 - 初始化时需传入具体类型引用，不能只靠泛型声明
- 示例：创建带泛型的 bucket
RBucket<Map<String, List<User>>> bucket = redisson.getBucket("my:bucket",
new JsonJacksonCodec(new TypeReference<Map<String, List<User>>>() {}));
存值时无需额外操作，但取值必须用 TypeReference
写入时直接 put 对象即可；读取时必须用 get() + 显式 TypeReference，否则会退化为原始集合类型。
- 错误写法：
Map<String, List<User>> data = bucket.get();→ 编译通过，运行时 ClassCastException - 正确写法：
Map<String, List<User>> data = bucket.get(new TypeReference<Map<String, List<User>>>() {}); - 注意：
TypeReference是匿名子类，必须用new TypeReference<>() {}形式，不能用 lambda 或静态引用
自定义对象需满足 Jackson 序列化要求
如果 User 类含私有字段、无参构造、或使用 Lombok，需确保 Jackson 能正常读写：
立即学习“Java免费学习笔记（深入）”；
- 字段建议加
@JsonProperty（尤其非标准命名） - Lombok 用户需添加
@NoArgsConstructor和@AllArgsConstructor（或@Data+@RequiredArgsConstructor） - 避免使用不可序列化的成员（如
ThreadLocal、InputStream） - 若字段含泛型（如
Map<Integer, LocalDateTime>），Jackson 默认可处理；但自定义类型需注册模块（如JavaTimeModule）
替代方案：封装为简单 POJO 避免泛型嵌套
若频繁操作深度泛型结构，更稳健的做法是定义明确的容器类：
- 例如：定义
UserGroupData类，包含Map<String, List<User>> usersByDept; - 然后使用
RBucket<UserGroupData>，序列化/反序列化更稳定，IDE 和调试也更友好 - 适用于业务逻辑清晰、结构固定的场景，比动态泛型更易维护
