Java Spring Boot Redis缓存操作教程

本文深入剖析了Spring Boot中使用StringRedisTemplate进行Redis字符串缓存操作的常见陷阱与最佳实践，聚焦于set()写入失败、get()返回null的真实含义、setIfAbsent()的幂等性应用、multiGet()与pipeline的性能权衡等高频痛点，通过配置检查、序列化器纠偏、过期时间单位辨析及实操建议，帮助开发者避开连接异常、序列化乱码、键自动过期、并发误覆盖等隐蔽坑位，让缓存真正稳定、高效、可预期。

StringRedisTemplate.opsForValue() 为什么存不进去数据？

最常见原因是没调用 set() 或调用后没等异步写入完成就查，尤其在单元测试里容易误判“没存进去”。StringRedisTemplate 默认使用 Lettuce 客户端，操作是异步的，但 set() 方法本身是同步阻塞的（会等命令发出去并收到响应），所以一般不是异步导致的“消失”，而是键过期、序列化器配置错、或 Redis 连接根本没通。

• 检查 redis-cli ping 能否连上，确认 spring.redis.host 和 port 配置正确
• 确认没启用 StringRedisTemplate 的默认 jdkSerializationRedisSerializer——它会对字符串加包装，导致 get() 返回乱码或 null；应确保使用 StringRedisTemplate（而非 RedisTemplate），它默认用 StringRedisSerializer
• 用 redis-cli keys "*" 确认键是否真没写入，而不是被自动过期（比如误传了负数 timeout）

set() 和 setIfAbsent() 到底该用哪个？

二者语义差异直接影响并发逻辑。前者无条件覆盖，后者只在 key 不存在时写入，返回 true 表示成功设值，false 表示 key 已存在——这是实现简单分布式锁或防重复提交的关键。

• template.opsForValue().set("user:1001", "Alice")：直接覆盖，适合更新场景
• template.opsForValue().setIfAbsent("order:20240501", "pending", Duration.ofSeconds(30))：带过期时间的原子设值，适合幂等初始化
• 注意：setIfAbsent 的过期时间参数是 JDK 8+ 的 Duration，传 long 会调用老版本重载，单位是秒而非毫秒，容易设错

get() 返回 null 是缓存穿透还是真没值？

null 只代表 Redis 里没有这个 key，不区分“从未写入”和“写入后删掉”。如果业务上“用户不存在”和“缓存未命中”要区分开，得靠额外手段，比如缓存空对象或布隆过滤器。

• 直接 template.opsForValue().get("user:9999") 返回 null，就是 key 不存在
• 如果想避免反复查 DB，可手动缓存 "null" 字符串（如 set("user:9999", "NULL", Duration.ofMinutes(2))），读到再转成 null
• 别依赖 hasKey() 做前置判断——它和 get() 是两次网络往返，不如直接 get() 后判空，更省开销

批量操作用 multiGet() 还是 pipeline？

multiGet() 是单命令批量取值，底层发一个 MGET，性能好、原子；pipeline 是客户端打包多条命令一次性发，适合混合读写，但需要自己处理返回顺序和类型。

• 纯批量读：用 template.opsForValue().multiGet(Arrays.asList("k1", "k2", "k3"))，简洁且高效
• 混合操作（比如先 get 再 set）：必须用 template.executePipelined()，否则无法保证顺序或事务性
• 注意：multiGet() 返回 List，对应位置可能为 null，别直接用 get(0).length()，先判空

Redis 的 string 操作看着简单，但 set 的过期单位、get 的 null 含义、以及 pipeline 里异常不中断这些细节，一不留神就会在压测或上线后冒出来。

今天关于《Java Spring Boot Redis缓存操作教程》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！