Spring Boot 整合 Redis 使用教程

embedded/2025/3/19 6:10:27/

Redis 是一种高性能的键值存储数据库，常用于缓存、会话管理和消息队列等场景。Spring Boot 通过 Spring Data Redis 提供了简洁的整合方式。

1. 环境准备

1.1 添加依赖

在 pom.xml 中添加 Redis 依赖（Spring Boot 3.x）：

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<!-- 若使用 Jedis 客户端 -->
<dependency><groupId>redis.clients</groupId><artifactId>jedis</artifactId>
</dependency>

2. 配置 Redis 连接

在 application.properties 中配置 Redis 连接信息：

spring.data.redis.host=localhost
spring.data.redis.port=6379
spring.data.redis.password=  # 若无密码则留空
spring.data.redis.database=0

3. 使用 RedisTemplate 操作 Redis

3.1 注入 RedisTemplate

Spring Boot 自动配置了 RedisTemplate，可直接注入使用：

java">@Autowired
private RedisTemplate<String, Object> redisTemplate;

3.2 基础操作示例

java">// 存储字符串
redisTemplate.opsForValue().set("name", "Alice");// 获取字符串
String name = (String) redisTemplate.opsForValue().get("name");
System.out.println("Name: " + name); // 输出: Alice// 设置过期时间（30秒）
redisTemplate.expire("name", 30, TimeUnit.SECONDS);// 删除键
redisTemplate.delete("name");

3.3 存储对象（JSON序列化）

默认序列化可能存在问题，建议配置自定义序列化（在配置类中添加）：

java">@Configuration
public class RedisConfig {@Beanpublic RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {RedisTemplate<String, Object> template = new RedisTemplate<>();template.setConnectionFactory(factory);template.setKeySerializer(new StringRedisSerializer());template.setValueSerializer(new GenericJackson2JsonRedisSerializer());return template;}
}

存储自定义对象：

java">User user = new User("Bob", 25);
redisTemplate.opsForValue().set("user:1", user);
User cachedUser = (User) redisTemplate.opsForValue().get("user:1");

4. 使用 Spring Cache 注解

4.1 启用缓存

在启动类添加 @EnableCaching：

java">@SpringBootApplication
@EnableCaching
public class Application { ... }

4.2 缓存方法结果

java">@Service
public class UserService {@Cacheable(value = "userCache", key = "#id")public User getUserById(String id) {// 模拟数据库查询return new User(id, "CacheUser", 30);}@CacheEvict(value = "userCache", key = "#id")public void deleteUser(String id) {// 删除数据库记录}
}

5. 测试 Redis 连接

创建一个简单的测试类：

java">@Component
public class RedisTest implements CommandLineRunner {@Autowiredprivate RedisTemplate<String, String> redisTemplate;@Overridepublic void run(String... args) {redisTemplate.opsForValue().set("testKey", "Hello Redis!");String value = redisTemplate.opsForValue().get("testKey");System.out.println("Redis测试值: " + value); // 输出: Hello Redis!}
}