Java 后端 / 系统课时
连接 Redis 与操作常用结构
连接 Redis 与操作常用结构
本课完成 Spring Boot 与 Redis 的最小可运行集成:启动本地 Redis、配置连接与序列化,再用 RedisTemplate 操作 String、Hash、List、Set 和 ZSet,并从控制台与 Redis CLI 双重验证结果。
学习目标
- 接入 Spring Data Redis 并确认连接可用
- 为键、普通值和 Hash 字段配置一致的序列化方式
- 根据业务访问方式选择并操作五种常用 Redis 结构
准备 Redis 与项目依赖
本地没有 Redis 时,可用 Docker 启动一个只用于学习的实例。
docker run --name lesson-redis -p 6379:6379 -d redis:7-alpine预期输出
<ID><ID> 是容器 ID,实际值每次不同。已有同名容器时可改名,或执行 docker start lesson-redis。
在现有 Spring Boot 3 项目的 pom.xml 中加入 Redis Starter。Spring Boot 会根据配置创建连接工厂,默认客户端为 Lettuce。
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>在 application.yml 中配置连接。这里允许通过环境变量覆盖地址、端口和密码,未设置时连接本机 6379 端口。
spring:
data:
redis:
host: ${REDIS_HOST:localhost}
port: ${REDIS_PORT:6379}
password: ${REDIS_PASSWORD:}
timeout: 2s配置生效后,应用启动时不一定立即访问 Redis,因此真正的连通性要通过后面的读写操作验证。
理解模板与序列化
Redis 最终保存的是字节序列。RedisTemplate 决定 Java 对象如何转换为字节,以及读回时如何恢复对象;写入与读取使用不同序列化器,会出现键看似存在但程序无法正确反序列化的问题。
本课让键和 Hash 字段使用可读的字符串序列化,让普通值和 Hash 值使用 JSON 序列化。这样既方便在 Redis CLI 中定位键,也能保存字符串、数字、集合或普通对象。

| Redis 结构 | Spring 操作入口 | 适合的问题 |
|---|---|---|
| String | opsForValue() |
单值缓存、计数器、短期令牌 |
| Hash | opsForHash() |
按字段读写对象 |
| List | opsForList() |
保留顺序的任务或消息 |
| Set | opsForSet() |
去重标签、成员关系 |
| ZSet | opsForZSet() |
带分数排序、排行榜 |
配置 RedisTemplate
将以下配置保存为 RedisConfig.java。四类序列化器必须成对设置,避免普通值和 Hash 值采用不一致格式。
package com.example.redis;
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
RedisTemplate<String, Object> redisTemplate(
RedisConnectionFactory connectionFactory) {
StringRedisSerializer stringSerializer = new StringRedisSerializer();
GenericJackson2JsonRedisSerializer jsonSerializer =
new GenericJackson2JsonRedisSerializer();
RedisTemplate<String, Object> template = new RedisTemplate<>();
template.setConnectionFactory(connectionFactory);
// 键保持可读,便于运维定位和统一命名空间
template.setKeySerializer(stringSerializer);
template.setHashKeySerializer(stringSerializer);
// 值统一使用 JSON,避免默认 JDK 序列化产生不可读二进制
template.setValueSerializer(jsonSerializer);
template.setHashValueSerializer(jsonSerializer);
template.afterPropertiesSet();
return template;
}
}该配置不会主动创建数据。验证标准是:应用能完成一次写入和读取,Redis CLI 能看到 demo: 前缀的键,并且重启应用后仍能按同一序列化规则读取。
操作五种常用结构
将以下类保存为 RedisStructureDemo.java。程序每次运行先删除演示键,确保输出不会受上一次执行残留数据影响。
package com.example.redis;
import java.time.Duration;
import java.util.List;
import java.util.Map;
import java.util.Set;
import org.springframework.boot.CommandLineRunner;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.stereotype.Component;
@Component
public class RedisStructureDemo implements CommandLineRunner {
private static final String GREETING_KEY = "demo:greeting";
private static final String USER_KEY = "demo:user:1001";
private static final String TASKS_KEY = "demo:tasks";
private static final String ROLES_KEY = "demo:roles";
private static final String RANKING_KEY = "demo:ranking";
private final RedisTemplate<String, Object> redisTemplate;
public RedisStructureDemo(RedisTemplate<String, Object> redisTemplate) {
this.redisTemplate = redisTemplate;
}
@Override
public void run(String... args) {
redisTemplate.delete(List.of(
GREETING_KEY, USER_KEY, TASKS_KEY, ROLES_KEY, RANKING_KEY
));
// String:保存单值并设置 10 分钟过期时间
redisTemplate.opsForValue()
.set(GREETING_KEY, "hello", Duration.ofMinutes(10));
// Hash:对象字段可独立读取和更新
redisTemplate.opsForHash().putAll(
USER_KEY,
Map.of("name", "Ada", "level", 5)
);
// List、Set、ZSet 分别演示顺序、去重和按分数排序
redisTemplate.opsForList()
.rightPushAll(TASKS_KEY, "review", "deploy");
redisTemplate.opsForSet()
.add(ROLES_KEY, "ADMIN", "AUDITOR", "ADMIN");
redisTemplate.opsForZSet()
.add(RANKING_KEY, "alice", 98.5);
Object greeting = redisTemplate.opsForValue().get(GREETING_KEY);
Object userName = redisTemplate.opsForHash().get(USER_KEY, "name");
List<Object> tasks =
redisTemplate.opsForList().range(TASKS_KEY, 0, -1);
Long roleCount = redisTemplate.opsForSet().size(ROLES_KEY);
Boolean hasAdmin =
redisTemplate.opsForSet().isMember(ROLES_KEY, "ADMIN");
Set<Object> topOne =
redisTemplate.opsForZSet().reverseRange(RANKING_KEY, 0, 0);
System.out.println("greeting=" + greeting);
System.out.println("user.name=" + userName);
System.out.println("tasks=" + tasks);
System.out.printf(
"roleCount=%d, hasAdmin=%s%n", roleCount, hasAdmin
);
System.out.println("top1=" + topOne);
}
}运行应用。
./mvnw spring-boot:run预期输出
greeting=hello
user.name=Ada
tasks=[review, deploy]
roleCount=2, hasAdmin=true
top1=[alice]Set 中重复写入的 ADMIN 只保留一份,因此成员数为 2;ZSet 按分数排序,本例只有 alice 一个成员。
用 Redis CLI 复核
下面的命令从 Redis 侧检查结构类型、过期时间和集合大小,不依赖 Java 日志。
docker exec lesson-redis redis-cli TYPE demo:greeting
docker exec lesson-redis redis-cli TTL demo:greeting
docker exec lesson-redis redis-cli LLEN demo:tasks
docker exec lesson-redis redis-cli SCARD demo:roles
docker exec lesson-redis redis-cli ZREVRANGE demo:ranking 0 0预期输出
string
<TTL_SECONDS>
2
2
alice<TTL_SECONDS> 会从接近 600 持续递减。若第一条返回 none,优先检查应用是否真的执行了演示类、Redis 地址是否一致,以及容器端口是否正确映射。
处理序列化与结构边界
序列化规则一旦修改,历史数据可能无法按新规则读取。生产环境应给键增加稳定命名空间和版本,例如 user:v1:<ID>,升级格式时使用新版本前缀或安排数据迁移,不要直接让新旧格式混用。
数据结构应由访问方式决定。需要按字段更新时选 Hash,需要去重时选 Set,需要分数排序时选 ZSet;不要因为 Java 中使用了 List,就机械地把整个对象序列化进 Redis List。
所有临时缓存都应明确 TTL。批量扫描生产键空间时使用 SCAN 思路,不要用会阻塞 Redis 的全量 KEYS 查询作为业务逻辑。