Spring Data Redis：把 Redis 接进 Java

这一课你将能做到

1. 说出接入 Redis 需要的依赖和 yml 配置项（Boot 3.x 的 spring.data.redis 前缀），并解释本站为什么用 StringRedisTemplate 而不是裸 RedisTemplate
2. 逐行读懂 RedisConfig.java 的 4 个 Bean，说出 Lettuce 和 Jedis 的区别
3. 用 opsForValue/opsForHash/opsForZSet 完成 Java 侧读写，并亲眼认清 JDK 序列化乱码坑

为什么要学

命令行操作你已经熟练，但生产代码里所有 Redis 交互都发生在 Java 里。这一步的坑最多：

• 依赖加了、配置前缀写错（spring.redis vs spring.data.redis），启动直接失败
• 用了默认 RedisTemplate，取出来的值带一堆 \xac\xed\x00\x05 乱码，redis-cli 里根本看不懂
• 序列化方案选错，换个人接手就读不出历史数据

本站已经踩平了这些坑：RedisConfig.java（backend/src/main/java/com/codeforge/config/RedisConfig.java）就是标准答案。这一课带你逐行读懂它，之后写自己的缓存层就是在它上面加积木。

先建立图像

Java 访问 Redis 的层次结构：

你的业务代码
  → StringRedisTemplate（好用的门面：opsForValue/opsForHash...）
    → LettuceConnectionFactory（连接工厂 = 水管）
      → Lettuce（底层客户端，netty 实现，线程安全）
        → Redis 服务端

RedisTemplate<Object,Object>（默认版）：值序列化用 JDK → 乱码源头
StringRedisTemplate：键值都按 UTF-8 字符串序列化 → redis-cli 可读

跟着做

步骤 1：确认依赖

backend/pom.xml 里的四件套：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-redis-jackson</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-cache</artifactId>
</dependency>
<!-- caffeine：本站本地缓存层，配合 spring-boot-starter-cache -->

spring-boot-starter-data-redis 默认带 Lettuce 客户端，无需额外引驱动。

步骤 2：yml 配置

application.yml（本机默认关）：

codeforge:
  redis:
    enabled: false

application-prod.yml（生产开，全部走环境变量）：

spring:
  data:
    redis:
      host: ${REDIS_HOST:127.0.0.1}
      port: ${REDIS_PORT:6379}
      password: ${REDIS_PASSWORD:}
codeforge:
  redis:
    enabled: true

注意坐标是 spring.data.redis——Boot 3.x 从 spring.redis 迁移了过来，老教程的写法在 Boot 3.5.4 上配不上。