第 8 节:SpringBoot3 整合 Redis7
项目:com.zzs.szyt
前置:Redis7 已经安装并启动(本地 Windows / 服务器 Linux 都可以),记住 Redis 的 IP、端口、密码
目标:引入 Redis 依赖、配置 yml、封装 Redis 工具类、写测试接口,实现缓存读写,Postman 测试
1. pom.xml 新增 Redis 依赖
打开 pom.xml,在 <dependencies> 里面添加:
<!-- SpringBoot3 Redis 依赖,spring-data-redis -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<!-- 连接池 lettuce(SpringBoot3默认用lettuce,不是jedis) -->
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-pool2</artifactId>
</dependency>
添加完,点击 IDEA 右侧 Maven 刷新按钮,拉取依赖。
2. 多环境 yml 配置 Redis
分别修改 application-dev.yml、application-prod.yml
dev(本地开发环境,本地 Redis)
spring:
data:
redis:
host: 127.0.0.1
port: 6379
password: # 本地Redis没密码就空着
database: 0 # 选第0号库
lettuce:
pool:
max-active: 8
max-idle: 8
min-idle: 0
max-wait: 1000ms
prod(服务器生产环境,改成服务器 Redis 地址 + 密码)
spring:
data:
redis:
host: 你的服务器IP
port: 6379
password: 你的redis密码
database: 0
lettuce:
pool:
max-active: 8
max-idle: 8
min-idle: 0
max-wait: 1000ms
⚠️ SpringBoot3 是
spring.data.redis,不是 spring.redis,写错直接连不上!
3. 新建 Redis 配置类(解决序列化乱码问题,必加)
新建包:com.zzs.szyt.config
新建类 RedisConfig.java
package com.zzs.szyt.config;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.redis.connection.RedisConnectionFactory;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.data.redis.serializer.GenericJackson2JsonRedisSerializer;
import org.springframework.data.redis.serializer.StringRedisSerializer;
@Configuration
public class RedisConfig {
@Bean
public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
RedisTemplate<String, Object> template = new RedisTemplate<>();
template.setConnectionFactory(factory);
// key 使用字符串序列化
StringRedisSerializer stringSerializer = new StringRedisSerializer();
// value 使用json序列化
GenericJackson2JsonRedisSerializer jsonSerializer = new GenericJackson2JsonRedisSerializer();
template.setKeySerializer(stringSerializer);
template.setHashKeySerializer(stringSerializer);
template.setValueSerializer(jsonSerializer);
template.setHashValueSerializer(jsonSerializer);
template.afterPropertiesSet();
return template;
}
}
作用:默认序列化会存二进制乱码,这个配置让 Redis 存可读 JSON,方便可视化工具查看。
4. 封装 Redis 工具类(方便后续业务调用)
新建包:com.zzs.szyt.util
新建 RedisUtil.java
package com.zzs.szyt.util;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.stereotype.Component;
import javax.annotation.Resource;
import java.util.concurrent.TimeUnit;
@Component
public class RedisUtil {
@Resource
private RedisTemplate<String, Object> redisTemplate;
/**
* 设置key-value,带过期时间
* @param key 键
* @param value 值
* @param expireTime 过期时长
* @param unit 时间单位
*/
public void set(String key, Object value, long expireTime, TimeUnit unit) {
redisTemplate.opsForValue().set(key, value, expireTime, unit);
}
/**
* 设置key-value,永久不过期
*/
public void set(String key, Object value) {
redisTemplate.opsForValue().set(key, value);
}
/**
* 获取值
*/
public Object get(String key) {
return redisTemplate.opsForValue().get(key);
}
/**
* 删除key
*/
public Boolean delete(String key) {
return redisTemplate.delete(key);
}
/**
* 判断key是否存在
*/
public Boolean hasKey(String key) {
return redisTemplate.hasKey(key);
}
}
5. 写 Redis 测试 Controller
com.zzs.szyt.controller 新建 RedisTestController.java
package com.zzs.szyt.controller;
import com.zzs.szyt.util.RedisUtil;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import javax.annotation.Resource;
import java.util.concurrent.TimeUnit;
import java.util.HashMap;
import java.util.Map;
@RestController
@RequestMapping("/redis")
public class RedisTestController {
@Resource
private RedisUtil redisUtil;
// 存入字符串
@GetMapping("/set")
public Map<String,Object> setRedis(@RequestParam String key, @RequestParam String value){
redisUtil.set(key, value, 30, TimeUnit.MINUTES);
Map<String,Object> res = new HashMap<>();
res.put("msg","存入成功");
res.put("key",key);
res.put("value",value);
return res;
}
// 读取
@GetMapping("/get")
public Map<String,Object> getRedis(@RequestParam String key){
Object val = redisUtil.get(key);
Map<String,Object> res = new HashMap<>();
res.put("msg","查询成功");
res.put("key",key);
res.put("value",val);
return res;
}
// 删除
@GetMapping("/del")
public Map<String,Object> delRedis(@RequestParam String key){
redisUtil.delete(key);
Map<String,Object> res = new HashMap<>();
res.put("msg","删除成功");
res.put("key",key);
return res;
}
}
6. 启动项目 + Postman 测试
✅ 先确认:Redis 服务已经启动!

- 启动 szyt 项目,观察控制台,没有 Redis 连接报错就是连接成功
- Postman 测试接口:
- 存入:
GET http://localhost:8080/redis/set?key=name&value=zhangsan - 读取:
GET http://localhost:8080/redis/get?key=name - 删除:
GET http://localhost:8080/redis/del?key=name


7. 本章节验收标准
- 项目正常启动,无 Redis 连接异常
- Postman 可以正常写入、读取、删除 Redis 数据
- 可以用 Redis 可视化工具(Redis Desktop Manager 等)看到存入的数据