HoRain云--SpringBoot集成Redisson全攻略-编程实验室

🎬 HoRain云小助手：个人主页

🔥 个人专栏: 《Linux 系列教程》《c语言教程》

⛺️生活的理想，就是为了理想的生活!

⛳️ 推荐

前些天发现了一个超棒的服务器购买网站，性价比超高，大内存超划算！忍不住分享一下给大家。点击跳转到网站。

专栏介绍

专栏名称	专栏介绍
《C语言》	本专栏主要撰写C干货内容和编程技巧，让大家从底层了解C，把更多的知识由抽象到简单通俗易懂。
《网络协议》	本专栏主要是注重从底层来给大家一步步剖析网络协议的奥秘，一起解密网络协议在运行中协议的基本运行机制！
《docker容器精解篇》	全面深入解析 docker 容器，从基础到进阶，涵盖原理、操作、实践案例，助您精通 docker。
《linux系列》	本专栏主要撰写Linux干货内容，从基础到进阶，知识由抽象到简单通俗易懂，帮你从新手小白到扫地僧。
《python 系列》	本专栏着重撰写Python相关的干货内容与编程技巧，助力大家从底层去认识Python，将更多复杂的知识由抽象转化为简单易懂的内容。
《试题库》	本专栏主要是发布一些考试和练习题库（涵盖软考、HCIE、HRCE、CCNA等）

方式二：手动配置 RedissonClient（推荐用于生产环境）

🚀 核心功能与应用示例

⚠️ 常见问题与解决方案

💎 总结与最佳实践

在 Spring Boot 项目中集成 Redisson 可以为你的应用轻松注入分布式能力，例如分布式锁、分布式集合等。下面我将为你梳理两种主要的集成方式、详细步骤、最佳实践以及常见问题的解决方案。

🔌 两种集成方式概览

Redisson 提供了两种主流的集成方式，下表对比了它们的核心差异，帮助你根据项目情况做出选择。

特性维度	Redisson Spring Boot Starter（自动配置）	手动配置 RedissonClient
配置方式	通过`application.yml`/`application.properties`自动配置	手动创建`Config`对象，代码显式配置
灵活性	相对较低，遵循 Spring Boot 约定	高，可对连接参数、连接池等细节进行精细控制
适用场景	适用于标准 Redis 连接，希望快速集成	适用于非 Spring Boot 项目、复杂拓扑（如集群）、或有特殊配置需求（如 SSL、特定超时）的场景
代码量	少，简洁	较多，但控制力强

📦 集成步骤详解

方式一：使用 Starter 自动配置

这种方式遵循 Spring Boot 的约定，适合快速开始。

添加 Maven 依赖

在pom.xml中添加 Starter 依赖。

<dependency> <groupId>org.redisson</groupId> <artifactId>redisson-spring-boot-starter</artifactId> <version>3.23.4</version> <!-- 建议使用最新版本 --> </dependency>

配置连接信息
在application.yml中配置 Redis 服务器基本信息。
```
spring: redis: host: localhost port: 6379 # 如果有密码 password: your-redis-password
```
如果需要更详细的 Redisson 专属配置（如连接池），可以在application.yml中配置redisson.config相关属性。

方式二：手动配置 RedissonClient（推荐用于生产环境）

手动配置提供了更大的灵活性和可控性，以下是更稳健的做法。

添加 Maven 依赖
同样需要先引入依赖。你可以使用redisson-spring-boot-starter或仅引入核心包redisson。

创建独立的 Redisson 配置文件

建议将复杂的 Redisson 配置剥离到独立的 YAML 文件中（如redisson-config.yml），而不是全部写在application.yml里。这样做更清晰，也便于管理不同环境的配置。

# redisson-config.yml singleServerConfig: address: "redis://your-redis-host:6379" # 注意协议前缀 password: your-redis-password # 无需引号 database: 0 connectTimeout: 10000 timeout: 3000 connectionPoolSize: 64 connectionMinimumIdleSize: 10

编写 Java 配置类

创建配置类，通过@Bean方法手动创建RedissonClient。

package com.yourproject.config; import org.redisson.Redisson; import org.redisson.api.RedissonClient; import org.redisson.config.Config; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.core.io.ClassPathResource; import java.io.IOException; @Configuration public class RedissonConfig { @Bean(destroyMethod = "shutdown") // 确保应用关闭时优雅退出 public RedissonClient redissonClient() throws IOException { // 从 classpath 下的独立配置文件加载 Config config = Config.fromYAML(new ClassPathResource("redisson-config.yml").getInputStream()); return Redisson.create(config); } }

🚀 核心功能与应用示例

集成成功后，你可以在业务代码中通过@Autowired注入RedissonClient，并使用其丰富的功能。

基础数据操作

@Autowired private RedissonClient redissonClient; public void basicOperations() { // 操作普通的键值对 RBucket<String> bucket = redissonClient.getBucket("myKey"); bucket.set("value", 10, TimeUnit.MINUTES); // 设置值，10分钟过期 String value = bucket.get(); // 操作 Map RMap<String, Object> map = redissonClient.getMap("myMap"); map.put("field", "value"); }

分布式锁实践

分布式锁是 Redisson 最常用的功能之一，使用时务必注意加锁和释放的规范。

public void performTaskWithLock() { RLock lock = redissonClient.getLock("myDistributedLock"); try { // 尝试加锁，最多等待5秒，锁持有10秒后自动失效 if (lock.tryLock(5, 10, TimeUnit.SECONDS)) { try { // 成功获取锁，执行受保护的临界区代码 // ... your business logic here } finally { // 确保在finally块中释放锁，且只释放当前线程持有的锁 if (lock.isHeldByCurrentThread()) { lock.unlock(); } } } } catch (InterruptedException e) { Thread.currentThread().interrupt(); // 处理中断异常 } }