前言

在高并發、大數據量的應用場景中，緩存是提升系統性能的關鍵技術。Redis 憑借其卓越的讀寫性能、豐富的數據結構和高可用性，成為開發者常用的緩存工具。本教程將嚴格依據Spring 官方文檔與Redis 官方文檔，詳細介紹 Spring Boot 與 Redis 的集成步驟。

一、創建 Spring Boot 項目

Spring Initializr 是創建 Spring Boot 項目的官方推薦方式，通過它能快速生成包含 Redis 依賴的項目骨架：

1. 訪問Spring Initializr 官網；

2. 在頁面中填寫項目基本信息，如Group（組織標識符）、Artifact（項目名稱）；

3. 在Dependencies（依賴）搜索框中輸入Redis，選擇Spring Data Redis；

4. 點擊Generate生成項目壓縮包，解壓后使用 IDE 打開。

也可通過 IDE（如 IntelliJ IDEA）的New Project向導，選擇Spring Initializr，按上述步驟完成項目創建。

二、引入 Redis 依賴

根據 Spring Boot 官方文檔，spring-boot-starter-data-redis依賴整合了 Redis 操作所需的核心功能。在pom.xml文件中，默認情況下創建項目時已包含該依賴，若缺失，可手動添加：

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>

該依賴默認使用Lettuce作為 Redis 客戶端，Lettuce是基于 Netty 的響應式客戶端，在多線程環境下表現出色。若需使用傳統的Jedis客戶端，參考官方文檔，可添加如下配置：

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-redis</artifactId><exclusions><exclusion><groupId>io.lettuce</groupId><artifactId>lettuce-core</artifactId></exclusion></exclusions>
</dependency>
<dependency><groupId>redis.clients</groupId><artifactId>jedis</artifactId>
</dependency>

三、配置 Redis 連接信息

Spring Boot 官方文檔提供了多種配置 Redis 連接的方式，最常用的是在配置文件中設置。在application.properties或application.yml文件中，配置示例如下：

application.properties;

spring.redis.host=localhost
spring.redis.port=6379
spring.redis.password=
spring.redis.database=0
spring.redis.timeout=3000
# 連接池配置（可選）
spring.redis.lettuce.pool.max-idle=8
spring.redis.lettuce.pool.min-idle=0
spring.redis.lettuce.pool.max-active=8
spring.redis.lettuce.pool.max-wait=-1ms

application.yml;

spring:redis:host: localhostport: 6379password:database: 0timeout: 3000lettuce:pool:max-idle: 8min-idle: 0max-active: 8max-wait: -1ms

配置說明：

• spring.redis.host：Redis 服務器主機地址；

• spring.redis.port：Redis 服務器端口號；

• spring.redis.password：Redis 訪問密碼；

• spring.redis.database：使用的 Redis 數據庫編號（0 - 15）；

• spring.redis.timeout：連接超時時間；

• 連接池相關配置（以Lettuce為例）：用于控制連接池的大小和行為，提升連接管理效率。

四、編寫 Redis 操作代碼

1. 創建 Redis 配置類

參考 Spring 官方文檔，創建配置類以定制RedisTemplate。以Lettuce客戶端為例：

@Configurationpublic class RedisConfig {@Beanpublic RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory redisConnectionFactory) {RedisTemplate<String, Object> template = new RedisTemplate<>();template.setConnectionFactory(redisConnectionFactory);// 鍵使用String序列化template.setKeySerializer(new StringRedisSerializer());template.setHashKeySerializer(new StringRedisSerializer());// 值使用JSON序列化template.setValueSerializer(new GenericJackson2JsonRedisSerializer());template.setHashValueSerializer(new GenericJackson2JsonRedisSerializer());return template;}
}

上述代碼配置了RedisTemplate，通過合理設置序列化方式，方便對不同類型數據進行存儲和讀取。

2. 編寫 Redis 操作 Service;

封裝 Redis 常用操作，方便業務代碼調用：

@Servicepublic class RedisService {private final RedisTemplate<String, Object> redisTemplate;public RedisService(RedisTemplate<String, Object> redisTemplate) {this.redisTemplate = redisTemplate;}// 存儲數據public void set(String key, Object value) {redisTemplate.opsForValue().set(key, value);}// 存儲數據并設置過期時間public void set(String key, Object value, long timeout, TimeUnit unit) {redisTemplate.opsForValue().set(key, value, timeout, unit);}// 獲取數據public Object get(String key) {return redisTemplate.opsForValue().get(key);}// 刪除數據public void delete(String key) {redisTemplate.delete(key);}}

3. 測試 Redis 操作

使用 JUnit 5 編寫測試類驗證 Redis 操作：

@SpringBootTestpublic class RedisTest {@Autowiredprivate RedisService redisService;@Testpublic void testRedis() {// 存儲數據redisService.set("testKey", "testValue");// 獲取數據Object value = redisService.get("testKey");System.out.println("獲取到的值：" + value);// 刪除數據redisService.delete("testKey");Object deletedValue = redisService.get("testKey");System.out.println("刪除后獲取到的值：" + deletedValue);}
}

運行測試，若控制臺輸出預期結果，表明 Redis 集成成功。

五、使用 Redis 實現緩存

Spring 官方文檔提供了強大的緩存抽象機制，結合 Redis 可輕松實現緩存功能。

1. 啟用緩存

在 Spring Boot 主類上添加@EnableCaching注解：

@SpringBootApplication
@EnableCaching
public class Application {public static void main(String[] args) {SpringApplication.run(Application.class, args);}
}

2. 編寫 Service 方法并添加緩存注解

以用戶查詢為例：

@Servicepublic class UserService {// 模擬從數據庫查詢用戶public User getUserFromDatabase(String userId) {// 實際查詢數據庫邏輯return new User(userId, "John Doe");}// 使用@Cacheable緩存方法結果@Cacheable(value = "users", key = "#userId")public User getUser(String userId) {return getUserFromDatabase(userId);}
}

@Cacheable注解會根據value和key定義的規則，自動管理緩存的讀寫，當方法再次被調用時，若緩存存在則直接返回緩存數據，提升系統響應速度。

總結

通過以上步驟，依據官方文檔完成了 Spring Boot 與 Redis 的集成及緩存實現。實際開發中，還可探索 Redis 的發布訂閱、哨兵模式、集群模式等高級功能，進一步挖掘 Redis 潛力。若在實踐過程中有疑問，歡迎交流討論。