Spring Boot Redis StringRedisTemplate操作教程

本文深入剖析了 Spring Boot 中 StringRedisTemplate 字符串操作的常见陷阱与最佳实践，直击开发者最常遇到的“数据存不进去”“get 返回 null”“setIfAbsent 用错场景”等痛点，从连接配置、序列化器误用、过期时间单位混淆、异步认知偏差，到批量读取选型（multiGet vs pipeline）、缓存穿透应对策略等关键细节逐一拆解，既讲清原理（如 set 的同步性本质、StringRedisSerializer 的必要性），又给出可落地的排查步骤和代码示例，帮助你在实际项目中避开隐蔽坑位，写出稳定高效的 Redis 操作逻辑。

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()，先判空

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~