Spring Data Redis 快速上手

作者:独泪了无痕日期:2026/10/28

概述

在快速入门 Spring Data Redis 之前,我们先来做个简单的了解。在 Spring 的生态中,我们使用 Spring Data Redis 来实现对 Redis 的数据访问。可能这个时候,有人会有疑惑,市面上已经有 Redis、Redisson、Lettuce 等优秀的 Java Redis 工具库,为什么还要有 Spring Data Redis 呢?学不动了,头都要秃了!不要慌,我们先来看一张图:

Jedis 是 Redis 官方推出的一款面向 Java 的客户端,提供了很多接口调用。并不是只有 Jedis 可以使用,像jdbc-redis、Jredis也都属于 Redis 的 Java 客户端,但他们之间是无法兼容的。如果在一个项目中使用了 Jedis,然后后来决定弃用掉改用 jdbc-redis 就比较麻烦了。Spring Data Redis 是 Spring Data 模块的一部分,专门用来支持在 Spring 应用程序对 Redis 的轻松配置和访问。Spring Data Redis 提供了统一的操作模板 RedisTemplate,封装了 Jedis、Lettuce 的 API 操作,访问 Redis 数据。所以,实际上,Spring Data Redis 内置真正访问的实际是 Jedis、Lettuce 等 API 操作。

基础建设

想象一下,你是一家跨国餐厅的经理,Redis 是你的冷库,Spring Data Redis 给你配了一个全能管家。你只需要告诉管家:“帮我把这筐苹果(Java 对象)存进 01 号柜。” 管家会自动帮你把苹果打包(序列化)、搬运、锁门,甚至还能把不同种类的货物分门别类(封装 API)。

依赖引入

在 Spring 中,spring-data-redis 项目对访问 Redis 进行了 API 封装,提供了便捷的访问方式。springBoot 项目中的子模块 spring-boot-starter-data-redis 基于 spring-data-redis 项目,做了二次封装,大大简化了 Redis 的相关配置。如果用的是 Spring Boot,则直接引入 starter,如下所示,它默认集成了 Lettuce 驱动,性能杠杠的。

1<!-- Spring Data Redis 依赖 -->
2<dependency>
3    <groupId>org.springframework.boot</groupId>
4    <artifactId>spring-boot-starter-data-redis</artifactId>
5</dependency>
6

这个 starter 会自动把 Spring Data Redis 的核心类、默认的 Lettuce 连接工厂都引入。如果需要配连接池,还需要额外引入 Apache Commons Pool2:

1<!-- 配置连接池需要的依赖 -->
2<dependency>
3    <groupId>org.apache.commons</groupId>
4    <artifactId>commons-pool2</artifactId>
5</dependency>
6

配置数据源

不同版本的 Spring Boot 配置前缀不一样,Spring Boot 2.x 使用以 spring.data.redis 为前缀属性的 RedisProperties 来配置,而 Spring Boot 3.x 则以 spring.data.redis 为前缀属性的 RedisProperties 来配置 Redis。在 resources/application.yml 文件中添加 Redis 配置,配置信息如下:

1spring:
2  data:
3    redis:
4      database: 0 # Redis 数据库索引,默认是0
5      host: 127.0.0.1 # Redis 服务器地址
6      port: 6379 # Redis 服务器连接端口
7      password: # Redis 服务器连接密码(默认为空)
8

Lettuce 本身是 Netty 实现的,单个连接可以承载很多并发操作。但实际在高并发场景下,个人建议还是配置连接池,主要目的是控制连接资源的占用上限,避免突发的连接风暴。下面是一个相对合理的配置参考:

1spring:
2  data:
3    redis:
4      host: 127.0.0.1
5      port: 6379
6      password: 
7      timeout: 3s
8      lettuce:
9        pool:
10          max-active: 16
11          max-idle: 8
12          min-idle: 2
13          max-wait: 3s
14
参数默认值生产建议简要说明
max-active816~64连接池中最大连接数,使用负值表示没有限制
max-idle8和 max-active 接近最大空闲连接数,空闲连接太多是资源浪费
min-idle02~4最小空闲连接数,保持基本的连接储备
max-wait-13000ms获取连接的最大等待时间,使用负值表示无限等待
timeout3s1~3s命令执行超时时间,超时会抛异常

核心配置类

Spring Data Redis 提供了两个常用的模板类:StringRedisTemplate 和 RedisTemplate,如下所示:

1@AutoConfiguration
2@ConditionalOnClass({RedisOperations.class})
3@EnableConfigurationProperties({RedisProperties.class})
4@Import({LettuceConnectionConfiguration.class, JedisConnectionConfiguration.class})
5public class RedisAutoConfiguration {
6
7    @Bean
8    // 当RedisTemplate对象Bean在IOC容器不存在时则会执行此方法创建对象放到IOC容器
9    // 若我们自己创建了RedisTemplate的对象Bean时,此方法则不会创建这个Bean对象
10    @ConditionalOnMissingBean(name = {"redisTemplate"})
11    // 表示当指定Bean在容器中只有一个,或者虽然有多个但是指定首选Bean
12    @ConditionalOnSingleCandidate(RedisConnectionFactory.class)
13    public RedisTemplate<Object, Object> redisTemplate(RedisConnectionFactory redisConnectionFactory) {
14        //  键和值都是Object类型的,默认序列化方式为:JdkSerializationRedisSerializer
15        //  JDK方式的序列化会导致我们的键和值转义
16        RedisTemplate<Object, Object> template = new RedisTemplate();
17        template.setConnectionFactory(redisConnectionFactory);
18        return template;
19    }
20
21    @Bean
22    // 当StringRedisTemplate的Bean对象不存在时则创建此对象放到Bean
23    @ConditionalOnMissingBean
24    @ConditionalOnSingleCandidate(RedisConnectionFactory.class)
25    public StringRedisTemplate stringRedisTemplate(RedisConnectionFactory redisConnectionFactory) {
26        //  键和值都是String类型的,默认序列化方式为:StringRedisSerializer
27        return new StringRedisTemplate(redisConnectionFactory);
28    }
29}
30

我们在大多数情况下会使用 RedisTemplate 及其对应包,它把底层连接细节封装掉了,同时又保留了 Redis 的完整操作能力,该模块为Redis交互提供了高级抽象、各种操作视图和丰富的通用接口,用于针对特定的类型或键做不同的操作。其默认的 Redis 序列化方式会导致缓存的 key、value 乱码(二进制字符),不便于查看,如下图所示:

为了解决这个问题,需要自定义序列化配置。创建一个 RedisTemplate 实例,key 统一用 StringRedisSerializer,value 用 GenericJackson2JsonRedisSerializer,这样既保证了可读性,又兼容了对象反序列化。

1import org.springframework.context.annotation.Bean;
2import org.springframework.context.annotation.Configuration;
3import org.springframework.data.redis.connection.RedisConnectionFactory;
4import org.springframework.data.redis.core.RedisTemplate;
5import org.springframework.data.redis.serializer.StringRedisSerializer;
6
7@Configuration
8public class RedisConfig {
9    @Bean
10    public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
11        // 配置我们自己的Redis模板,一般我们的key都为String,值为Object
12        RedisTemplate<String, Object> redisTemplate = new RedisTemplate<>();
13        // 为 Template 设置连接工厂
14        redisTemplate.setConnectionFactory(factory);
15
16        // 配置String序列化方式
17        StringRedisSerializer stringRedisSerializer = new StringRedisSerializer();
18        // 配置JSON序列化方式
19        GenericJackson2JsonRedisSerializer jsonSerializer = new GenericJackson2JsonRedisSerializer();
20        
21        // key、hash key 用 String 序列化,保证在 Redis 客户端里可读
22        redisTemplate.setKeySerializer(stringRedisSerializer);
23        redisTemplate.setHashKeySerializer(stringRedisSerializer);
24        
25		// value 用 JSON 序列化,可读且跨语言
26        redisTemplate.setValueSerializer(jsonSerializer);
27        redisTemplate.setHashValueSerializer(jsonSerializer);
28
29        // 设置默认序列化方式
30        redisTemplate.setDefaultSerializer(stringRedisSerializer);
31        
32        redisTemplate.afterPropertiesSet();
33
34        return redisTemplate;
35    }
36}
37

✅️ 由于本示例仅仅用于演示,因此将简单将字符串存储到 Redis,序列化对象使用 StringRedisSerializer。

使用 RedisTemplate 进行对象存储时,需要使存储对象实现 Serializable 接口,这样才能够成功将对象进行序列化。Spring Data Redis 提供了多种 Serializer 策略,这对使用 Redis 的开发者而言,实在是非常便捷。Spring Data Redis 提供了内置的 Serializer,如下表所示:

序列化策略简要说明
JdkSerializationRedisSerializer使用 JDK 的序列化手段,数据以字节流存储
StringRedisSerializer字符串编码,数据以 String 存储
JacksonJsonRedisSerializerjson 格式存储
OxmSerializerxml 格式存储

实战演练

在 Spring Data Redis 中提供了 RedisTemplate 工具类,里面封装了对 Redis 的操作,并且将不同的数据类型的操作 API 封装到了不同的类型中:

API返回类型简要说明
redisTemplate.opsForValue()ValueOperations操作 String 类型数据
redisTemplate.opsForHash()HashOperations操作 Hash 类型数据
redisTemplate.opsForList()ListOperations操作 List 类型数据
redisTemplate.opsForSet()SetOperations操作 Set 类型数据
redisTemplate.opsForZSet()ZSetOperations操作 SortedSet 类型数据
redisTemplate通用命令

操作字符串(String):简单的“存”与“取”

String 是 Redis 中最简单的基本数据类型,也是使用频率最高的类型,可以存储任何数据,比如计数器、验证码、简单缓存。RedisTemplate 通过的 opsForValue() 获取 ValueOperations 提供字符串操作。代码如下:

1@Autowired
2private RedisTemplate<String, Object> redisTemplate;
3
4@Test
5public void valueOperationsTest() {
6    String key = "spring-data-redis";
7    ValueOperations<String, Object> ops = redisTemplate.opsForValue();
8    // 写入数据到 Redis
9    ops.set(key, "Hi! Spring Data Redis");
10    // 从 Redis 获取数据
11    System.out.println(ops.get(key));
12}
13

通过 StringRedisTemplate 类,我们进行了一次 Redis SET 指令的执行。关于 RedisTemplate 是什么,我们先卖个关子,下面再来介绍。我们先来执行下测试方法,执行完成后,我们在控制台查询,看看是否真的执行成功了。

操作哈希(Hash):对象存储的最优解

Hash 就像是 Java 里的 Map,适合存储对象、购物车、Session 这类需要单独修改字段的数据,而不需要每次都序列化整个对象。通过 RedisTemplate 的 opsForHash() 可以拿到 HashOperations 进行操作,比如存用户信息,不用把整个对象序列化成一个 value,而可以把每个字段作为 hash field:

1@Autowired
2private RedisTemplate<String, Object> redisTemplate;
3
4@Test
5public void hashOperationsTest() {
6    String key = "user:100";
7    HashOperations<String, String, Object> hashOps = redisTemplate.opsForHash();
8    // 存入一个 User 的 ID 为 100,属性名是 name,值是 Tom
9    hashOps.put(key, "name", "Tom");
10    hashOps.put(key, "age", "20");
11
12    Object name = hashOps.get(key, "name");
13    System.out.println(name);
14
15
16    // 取出所有 Key
17    Set<String> keys = hashOps.keys(key);
18    keys.stream().filter(Objects::nonNull).forEach(System.out::println);
19
20    // 取出所有 Value
21    List<Object> values = hashOps.values(key);
22    values.stream().filter(Objects::nonNull).forEach(System.out::println);
23}
24

Hash 最大的好处就是可以只更新某一个字段,不需要重新写入整个对象。比如用户年龄发生变化,直接 hashOps.put 覆盖 age 字段即可。对高频更新的对象缓存来说,Hash 比 String 存整段 JSON 更节省流量和操作时间。

操作列表(List):消息队列的雏形

List 类型适合做消息队列、最新消息列表这类场景,其有序、可重复,支持两端操作,尤其是左右压入和弹出操作非常直观。通过 RedisTemplate 的 opsForList() 可以拿到 ListOperations 进行操作:

1@Autowired
2private RedisTemplate<String, Object> redisTemplate;
3
4@Test
5public void listOperationsTest() {
6    String key = "listKey";
7    ListOperations<String, Object> listOps = redisTemplate.opsForList();
8    
9    // 从左侧插入
10    Long pushResult = listOps.leftPush(queueKey, "task-1");
11
12    // 从右侧弹出
13    Object task = listOps.rightPop(queueKey);
14
15    // 阻塞式弹出,超时 3 秒
16    Object taskWithBlock = listOps.rightPop(queueKey, 3, TimeUnit.SECONDS);
17    
18    // 批量推入
19    listOps.leftPushAll(key, "a", "b", "c");
20    
21    // 范围查询:0 到 -1 代表查询所有
22    List<Object> range = listOps.range(key, 0, -1);
23    System.out.println(range); // 输出: [c, b, a] (后进先出)
24}
25

✅ 这里要提个醒:List 做消息队列只是轻量方案,消息不消费会一直堆积,没有消费者组的概念,也不能做消息回放。

操作去重集合(Set)

Set 类型适合存储不重复元素,支持交集、并集、差集等数学集合操作,比如用户标签、已读记录。通过 RedisTemplate 的 opsForSet() 可以拿到 SetOperations 进行操作:

1@Autowired
2private RedisTemplate<String, Object> redisTemplate;
3
4@Test
5public void setOperationsTest() {
6    SetOperations<String, Object> setOps = redisTemplate.opsForSet();
7
8    setOps.add("article:1001:tags", "java", "redis", "spring");
9    Set<Object> tags = setOps.members("article:1001:tags");
10    // 判断是否存在
11    Boolean isMember = setOps.isMember("article:1001:tags", "java");
12}
13

操作有序集合(ZSet):排行榜神器

有序集合(ZSet)在集合(Set)基础上增加了分数(score)概念,适合实现排行榜、签到积分这类需要排序的场景,它的每个元素带一个 score,Redis 会根据 score 自动排序。通过 RedisTemplate 的 opsForZSet() 可以拿到 ZSetOperations 进行操作:

1@Autowired
2private RedisTemplate<String, Object> redisTemplate;
3
4@Test
5public void zSetOperationsTest() {
6    ZSetOperations<String, Object> zSetOps = redisTemplate.opsForZSet();
7    zSetOps.add("rank", "player1", 100);
8    System.out.println(zSetOps.score("rank", "player1"));
9
10    // 给 player1 增加 10 分
11    zSetOps.incrementScore("rank", "player1", 10);
12    System.out.println(zSetOps.score("rank", "player1"));
13}
14

参考文档


《Spring Data Redis 快速上手》 是转载文章,点击查看原文。


相关推荐


JDK26中的Map.ofLazy
考虑考虑2026/10/20

前言 Map.ofLazy 是 Java 26 引入的一个预览 API,用于创建惰性初始化、不可变、线程安全的 Map。它的核心特点是:键在创建时就需要提供,但值只会在第一次被访问时才通过函数计算出来,从而延迟开销、节省内存 Map.ofLazy使用 Map.ofLazy使用 import java.util.Map; import java.util.Set; public class MapLazyDemo { static void main() { Map<S


类和对象下-初始化列表static与友元突破封装
傲世仙尊2026/10/17

类和对象(下):初始化列表是"定义的地方",static 与友元突破封装 我的github:(https://github.com/xcx55/ubuntu-linux-project) 感谢各位大佬参观我的github!! 类和对象"上""中"讲完了六大默认成员函数的前四个,"下"补齐最后一块:初始化列表——构造函数里最容易被当成"另一种写法"而低估的机制。这篇还顺手把 static 成员、友元、const 成员函数(连带最后两个取地址重载)一起收掉。 一、为什么有了函数体,还要初始化列表?


Windows鼠标失灵排查:Ctrl Alt Delete、Mouse Keys、USB控制器与驱动修复
kakakahahahaha2026/10/10

本文涵盖以下关键内容: 1. 鼠标不动时按三个键恢复:Ctrl+Alt+Delete、Ctrl+Shift+Esc、Alt+Shift+NumLock 2. 鼠标亮但动不了的原因:驱动问题、USB接口故障、系统卡顿 3. 鼠标灯不亮的解决方法:检查物理连接、更换电池、测试其他设备 4. 一键修复方案:设备管理器更新驱动、系统重启、鼠标键功能启用 5. 无线与有线鼠标的区别排查:针对不同类型鼠标的专属解决方案 一、鼠标不动了按什么键恢复 当鼠标突然失灵时,键盘快捷键是最快速的应急解决


关于OpenCV的商场人群聚集检测系统的设计与实现(opencv+yolov10)
千里码aicood2026/10/1

摘 要 随着城市化进程的加快,商场作为公共聚集场所,人群安全问题日益受到关注。为了有效预防和控制人群拥挤带来的风险,本文提出了一种基于PyQt和OpenCV的商场人群聚集检测系统的设计与实现,该系统采用了YOLOv10目标检测算法。背景和意义在于,该系统能够实时监测商场内的人群密度,为商场安全管理提供技术支持,保障顾客的安全和舒适的购物环境。 本文的主要内容包括:首先,介绍了人群聚集检测在商场安全管理中的重要性,并分析了现有技术的不足;其次,详细阐述了基于PyQt和OpenCV的商


erlang_pay 先验章,再拆包:支付回调的验签到底在防什么
leeyi2026/9/25

erlang_pay 系列第二篇。这篇不限于 Erlang——不管你用什么语言接支付,回调验签的原理是同一套。 第一篇:erlang_pay:为 Erlang 补上支付这块拼图 想象一个场景。 你的服务器收到一条 HTTP 请求,内容大意是: "你好,我是支付宝。订单 R123,用户已付款 1000 元,请发货。" 问题来了:你怎么知道这条消息真的来自支付宝? 发送方可能是支付宝的通知服务器,也可能是我——一台笔记本、一条 curl 命令就够了。如果你的服务器看到"支付成功"四个字就发货,


Go GOPROXY 兜底链的坑:从一次诡异的 CI lint 失败说起
江湖十年2026/9/17

首发地址:mp.weixin.qq.com/s/w49jd0zcp… 一天,我正在搬砖,本地修改完 Go 代码后,打算通过 make image 命令来构建 Docker 镜像进行测试。不过在构建镜像的过程中有一个报错,因为 make build 直接构建二进制已经通过,那肯定不是代码的问题,就没有在意。因为本机网络环境不是很好,大概率是网络问题导致 GOPROXY 代理站的模块拉取不到,直接让 Claude Code 帮我来解决。 Claude Code 非常给力,几秒钟就解决了问题,测试也很


Go 开发者也有自己的轻量工作流引擎了:go get 一行,5 分钟跑通一条审批流
mldong2026/9/9

一、搜"Go 工作流引擎",你会先搜到什么 场景很常见:公司一个 Go 服务(订单、工单、内部管理后台),产品说要加审批流。请假、报销、采购,单子从申请人出发,走到部门领导,复杂一点的要会签、按比例通过、退回发起人改材料、抄送一把手。 你去搜,会搜到 Temporal、Cadence、Asynq,再往外还有 Camunda。这些名字都很强,但花一个下午读下来你会发现,它们的主场是编排:长事务、任务重试、分布式补偿、跨服务的状态机。把它们请进一个 CRUD 系统里审批三张单子,等于为了走三张单子,


别再靠 Code Review 守底线:我做了一个静态分析项目 RedLine
潜龙勿用之化骨龙2026/9/1

Android 开发中,协程几乎已经成为异步编程的默认选择。但“使用协程”并不等于项目天然具备一致、可靠的异步模型。 很多项目在长期演进过程中都会出现类似情况:新的代码使用 suspend 和 Flow,旧模块仍然依赖 Callback、LiveData、RxJava 或 Java Future;有些人使用 Mutex 管理共享状态,有些人继续使用 synchronized 或 ReentrantLock;方法虽然标记为 suspend,内部却调用 Thread.sleep()。 之前写过And


Go 编程实战:闭包 Closure——函数如何记住外部变量
程序员爱钓鱼2026/8/24

上一篇我们学习了匿名函数 Anonymous Function,知道函数不仅可以拥有名字,也可以直接写成: func() { fmt.Println("Hello Go") } 匿名函数还可以保存到变量、作为参数传递,甚至作为另一个函数的返回值。在学习匿名函数时,我们留下了一个非常重要的问题: count := 0 add := func() { count++ } add() add() fmt.Println(count) 最终输出: 2 为什么匿名函数内部可以访问并修改外部的 c


二级市场流动性“击鼓传花”全景分析:游戏逻辑、资金分工、周期规律与生存法则
初晴融雪-快雪时晴2026/8/11

核心定调:A股二级市场绝大多数短期题材炒作、热点轮动、妖股行情,本质不是价值投资,而是依托流动性的击鼓传花零和游戏。股价涨跌与企业基本面脱钩,只取决于“当下有没有人愿意用更高价格接盘”。鼓声不停、 风险提示:本文为市场规律复盘分析,不构成任何个股买卖、投资操作建议,投机炒作风险极高,普通投资者需谨慎参与。 一、基础认知:什么是股市击鼓传花游戏?(核心定义) 传统价值投资逻辑:股价=企业未来现金流折现,靠企业盈利增长、分红、估值修复赚钱。 击鼓传花投机逻辑:股价=流动性情绪+资金接力

首页编辑器站点地图

本站内容在 CC BY-SA 4.0 协议下发布

Copyright © 2026 聚合阅读