StringRedisTemplate.opsForValue() 存不进数据最常见原因是未调用set()或连接/配置错误;set()是同步的,需检查Redis连通性、序列化器(应使用StringRedisSerializer)、键过期设置及是否误用RedisTemplate。

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 是客户端打包多条命令一次性发,适合混合读写,但需要自己处理返回顺序和类型。
立即学习“Java免费学习笔记(深入)”;
- 纯批量读:用
template.opsForValue().multiGet(Arrays.asList("k1", "k2", "k3")),简洁且高效 - 混合操作(比如先
get再set):必须用template.executePipelined(),否则无法保证顺序或事务性 - 注意:
multiGet()返回List<String>,对应位置可能为null,别直接用get(0).length(),先判空
set 的过期单位、get 的 null 含义、以及 pipeline 里异常不中断这些细节,一不留神就会在压测或上线后冒出来。










