Spring Boot 整合 Redis：从 Docker 部署到代码测试完整指南

Docker 环境下的 Redis 部署

在开始 Spring Boot 编码之前，首先需要准备一个可访问的 Redis 服务实例。使用 Docker 是最便捷的方式，它不仅隔离了环境，还便于版本控制。

第1步：拉取 Redis 镜像

选择稳定的 LTS 版本（如 6.2.6）以确保兼容性。

docker pull redis:6.2.6

第2步：创建本地配置文件

为了支持数据持久化和自定义配置，建议在宿主机创建映射目录：

mkdir -p /mydata/redis/conf
touch /mydata/redis/conf/redis.conf

第3步：启动 Redis 容器并挂载数据

执行以下命令，将宿主机的端口、数据目录和配置文件映射到容器中：

# 启动同时映射到对应文件夹
# 后面 \ 代表换行
docker run -p 6379:6379 --name redis \
-v /mydata/redis/data:/data \
-v /mydata/redis/conf/redis.conf:/etc/redis/redis.conf \
-d redis:6.2.6 redis-server /etc/redis/redis.conf

注意：Redis 6.0+ 默认开启了混合持久化（AOF + RDB），这意味着即使重启容器，之前插入的数据通常也能保留。如需更详细的配置参考，可查阅官方配置文件：Redis 6.2 Config。

第4步：验证安装与可视化管理

进入容器命令行进行测试：

docker exec -it redis redis-cli

建议使用 Redis Desktop Manager (RDM) 等可视化工具连接本地 Redis，能够直观地查看 Key-Value 数据和监控运行状态：

• 客户端工具推荐：RedisDesktopManager
• 连接地址通常为 192.168.x.x 及端口 6379

Spring Boot 整合 Redis 实现

当 Redis 服务运行正常后，即可在 Spring Boot 项目中引入依赖并进行配置。

第5步：引入 Starter 依赖

在项目的 pom.xml 中添加 spring-boot-starter-data-redis，它会自动引入 Lettuce 或 Jedis 客户端连接池。

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

第6步：配置连接信息

修改 application.yml 文件，指定 Redis 服务器的 IP 和端口：

spring:
  redis:
    host: 192.168.88.14
    port: 6379

第7步：编写测试用例

注入 StringRedisTemplate 即可完成基础的字符串类型读写操作。以下是一个简单的单元测试示例：

@Autowired
StringRedisTemplate stringRedisTemplate;

@Test
public void testStringRedisTemplate() {
    // 设置键值对，value 包含随机UUID以区分不同次运行
    stringRedisTemplate.opsForValue().set("hello", "world_" + UUID.randomUUID().toString());
    
    // 获取数据
    String hello = stringRedisTemplate.opsForValue().get("hello");
    System.out.println("保存的数据是：" + hello);
}

上述步骤完成后，Spring Boot 应用已成功连接到 Docker 中的 Redis。你可以根据业务需求扩展使用 Hash、List 等数据结构，或进一步封装 Cache 注解实现方法级别的缓存拦截。

以上就是 Spring Boot 整合 Redis 的详细教程，更多关于 Java 开发技巧的资料请关注本站其它相关文章！