1. 先说设计思路:缓存和分布式锁为什么总是成对出现
做SpringBoot项目,尤其是涉及高并发、集群部署的业务,Redis几乎成了标配。很多同学一上来就加依赖、写配置、用注解,一套操作猛如虎,结果线上数据错了、缓存失效了、请求打崩数据库了,才知道问题一堆。
我先说一个核心认知:缓存解决的是读多写少的性能问题,分布式锁解决的是多实例并发下的资源互斥问题,两者本来不是一个东西,但在很多场景里必须配合使用。
举一个最常见的例子:商品详情页。100万个请求同时打过来,数据库撑不住,于是你加了Redis缓存,第一次查库,之后读缓存,性能立竿见影。这个场景里核心是缓存。但换个场景:秒杀扣减库存,多个微服务实例同时扣减同一个商品的库存,如果只是读缓存、写缓存,就出大事了——两个请求同时读到库存为1,各自加一减一,最后库存变成0或者负数,数据直接错乱。这个场景里,你不仅需要缓存,还需要一把“跨进程的锁”,保证同一时刻只有一个实例在执行“查询-判断-修改”这个复合操作。
再有,缓存本身也有“并发重建”的问题。比如缓存的key过期了,一瞬间来了100个请求同时落库查询,数据库瞬间被打爆。这时候分布式锁的作用就是让100个请求里只有1个能真正去查库、回填缓存,其余99个要么等待,要么直接拿到旧值。这也就是大家常说的缓存击穿防护。
所以我的建议是:在一个SpringBoot项目里,把Redis缓存和分布式锁当成一对组合拳来设计,先想清楚业务里哪些数据需要缓存、哪些操作需要互斥,再动手写代码。本文会从依赖引入、序列化配置、缓存注解、锁的选型与实现,到常见的坑和排查手段,完整走一遍。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 缓存接入:依赖、配置、序列化器选择这些细节别图省事
2.1 依赖引入与基础配置
SpringBoot整合Redis的起步很简单,核心就两个依赖:
xml复制<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-pool2</artifactId>
</dependency>
第二个依赖是连接池用的,生产环境必须加。没有连接池的话,高并发下Redis连接会被反复创建销毁,性能损耗非常明显。配置方面,我习惯把连接参数单独拆一个redis:前缀的配置块:
yaml复制spring:
redis:
host: 127.0.0.1
port: 6379
password:
database: 0
timeout: 3000ms
lettuce:
pool:
max-active: 16
max-idle: 8
min-idle: 2
max-wait: 3000ms
注意max-wait这个参数,取不到连接时的最大等待时间。默认值是-1,也就是无限等待。我踩过一次坑:流量高峰期连接池被占满,所有线程都卡在等待连接上,接口超时堆积,最后把整个应用拖死。建议线上别用默认值,设置成1到3秒,宁可快速失败,也不要无限阻塞。
还有一个细节:SpringBoot 2.x以后默认用的是Lettuce连接器,不是Jedis。Lettuce基于Netty,线程安全,性能更好,我个人建议直接用默认实现,没必要换回Jedis。如果遇到连接不稳定、间歇性报错的问题,优先检查Redis服务端的timeout配置和Lettuce的shareNativeConnection参数碰撞,而不是急着换客户端。
2.2 序列化方案:这一步决定你缓存里存的是人能看懂的JSON还是乱码
很多新手直接用默认配置跑缓存,然后发现Redis Desktop Manager里存的全是\xAC\xED\x00\x05t...这种乱码。原因很简单:Spring默认用JdkSerializationRedisSerializer做序列化,对象经过Java原生序列化之后存进Redis,读出来也是一堆二进制。它的问题不只是看起来乱,还有三个实际影响:
- 存进去的内容人类不可读,排查问题全靠猜。
- 序列化后的体积比JSON大很多,浪费内存。
- 如果实体类结构变更,反序列化容易直接报错,兼容性差。
我强烈建议用GenericJackson2JsonRedisSerializer来做value的序列化,key用StringRedisSerializer。原因很直接:key本来是字符串,没必要转成二进制;value序列化成JSON之后,可读、可调、可兼容,RedisDesktopManager里一眼就能看到内容。
对应的配置类大概是这样:
java复制@Configuration
public class RedisConfig {
@Bean
public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
RedisTemplate<String, Object> template = new RedisTemplate<>();
template.setConnectionFactory(factory);
// key使用String序列化
StringRedisSerializer keySerializer = new StringRedisSerializer();
// value使用GenericJackson2Json序列化
GenericJackson2JsonRedisSerializer valueSerializer = new GenericJackson2JsonRedisSerializer();
template.setKeySerializer(keySerializer);
template.setHashKeySerializer(keySerializer);
template.setValueSerializer(valueSerializer);
template.setHashValueSerializer(valueSerializer);
template.afterPropertiesSet();
return template;
}
}
这里有个重要的“为什么”:为什么要用GenericJackson2JsonRedisSerializer而不是普通的Jackson2JsonRedisSerializer?因为前者会在JSON里额外保存@class类型信息,反序列化时能还原成对应的Java对象,不需要你手工指定类型;后者则需要你自己传入目标类型,用起来限制多。代价是JSON里多一个@class字段,稍微占几个字节,但换来的通用性完全值得。
但是!这里有一个很隐蔽的坑:GenericJackson2JsonRedisSerializer反序列化时,如果目标
