java封装redis工具类的核心目标是屏蔽序列化、连接管理等重复逻辑，提供set/get/delete等直觉化api，并内置缓存穿透/击穿防护及构造器注入支持。
Java 中封装 Redis 操作工具类，核心目标是屏蔽底层序列化、连接管理、空值处理、异常细节和缓存策略等重复逻辑，让业务代码只关注“存什么”和“取什么”。不写冗长的 redisTemplate.opsForValue().set(...)，而是直接调用 redisUtil.set("user:1001", user, 30, MINUTES) —— 这就是封装的价值。
统一序列化配置是前提
Spring Boot 默认的 RedisTemplate 使用 JDK 序列化，key 和 value 都会带乱码（如 \xac\xed\x00\x05t\x00\x08user:1001），必须重置序列化器：
- key 使用
StringRedisSerializer，保证可读性与兼容性 - value 使用
Jackson2JsonRedisSerializer，自动处理对象 ↔ JSON 转换 - 开启
ObjectMapper.enableDefaultTyping()，避免反序列化泛型丢失类型信息 - 该配置需通过
@Configuration类注入为 Bean，确保全局生效
基础操作方法要覆盖常用场景
工具类至少提供以下字符串类型（String）的核心能力，参数设计应贴近直觉：
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
-
set(String key, Object value)：默认永不过期，内部自动 JSON 序列化 -
set(String key, Object value, long timeout, TimeUnit unit)：支持 TTL，单位明确，避免手误写错毫秒/秒 -
<t> T get(String key, Class<t> clazz)</t></t>：自动反序列化为指定类型，返回 null 而非原始字符串 -
delete(String... keys)：批量删除，支持 varargs 简化调用 -
expire(String key, long timeout, TimeUnit unit)：单独设置过期时间，方便动态调整
进阶能力解决真实问题
生产环境不能只做“存取”，还要应对缓存穿透、击穿、雪崩。工具类可内建轻量级防护机制：
- 缓存穿透：对查不到的数据也缓存空对象（如
"null"或自定义空标记），并设较短过期时间（如 2 分钟） - 缓存击穿：提供“逻辑过期”版本方法，例如
setWithLogicalExpire(key, data, expireAfter)，将过期时间作为字段存入 JSON，由应用控制是否刷新 - 原子性保障：对计数类操作（如
incr、decr）封装为强类型方法，返回Long而非Object
用 Spring 管理 + 构造注入更可靠
避免 @Autowired 字段注入导致的 NPE 风险，推荐构造器注入：
- 工具类标注
@Service或@Component - 构造函数接收
RedisTemplate<string object></string>或StringRedisTemplate - 不依赖静态单例，便于单元测试 Mock，也符合 Spring 最佳实践
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
