综合实战：给本站加上 Redis 缓存层

这一课你将能做到

1. 独立写出一个生产级 TrackCacheService：JSON 读写、TTL 抖动、空安全降级（enabled=false 时零影响）
2. 把它挂进 TrackService 的读写路径：读时填充、写时先库后删、列表与详情成组失效
3. 用 curl + redis-cli 完成端到端验收，并用 Testcontainers 测试收尾——本 track 毕业作品

为什么要学

前 11 课你集齐了所有零件：命令（2~4）、TTL 与三防（5）、Cache-Aside（6）、Spring 接入（7）、会话（8）、部署（9）、广播（10）、测试（11）。但零件不等于整车。

这一课把零件装起来：给 TrackService.listAll() 加 Redis 缓存层。这是本站首页最高频的读接口，现在只有 Caffeine 30 秒本地缓存。做完这次实战，你将拥有一段可以写进简历、可以在面试里完整讲清楚的真实工程经验——不是背的，是你亲手写的。

先建立图像

改造后的完整链路：

GET /api/tracks
  → TrackService.listAll()
      → Caffeine（30s，本站已有）
          → miss → TrackCacheService.getTracks()
              → Redis GET coderoadmap:tracks:list（5min±抖动）
                  → hit  → JSON 反序列化返回
                  → miss → MySQL 查询 → 序列化写回 Redis → 返回

POST/PATCH/DELETE 管理（deleteTrack 等）
  → MySQL 落库成功
  → @CacheEvict（清 Caffeine）
  → trackCacheService.evictListAndTrack(slug)  ← DEL Redis 两个 key

跟着做

步骤 1：写 TrackCacheService

新建 backend/src/main/java/com/codeforge/cache/TrackCacheService.java：

@Service
public class TrackCacheService {

    private static final String LIST_KEY = "coderoadmap:tracks:list";
    private static final String TRACK_KEY_PREFIX = "coderoadmap:track:";
    private static final Duration BASE_TTL = Duration.ofMinutes(5);
    private static final long JITTER_SECONDS = 60;

    private final StringRedisTemplate redis;      // enabled=false 时为 null
    private final ObjectMapper objectMapper;

    public TrackCacheService(ObjectProvider<StringRedisTemplate> redisProvider,
                             ObjectMapper objectMapper) {
        this.redis = redisProvider.getIfAvailable();   // 开关关 → null，不报错
        this.objectMapper = objectMapper;
    }

    public boolean isAvailable() {
        return redis != null;
    }

    /** 读列表缓存：miss 或任何异常都返回 null（由调用方回源 MySQL） */
    public String getListRaw() {
        if (redis == null) return null;
        try {
            return redis.opsForValue().get(LIST_KEY);
        } catch (Exception e) {
            return null;                     // Redis 挂了不拦路：降级直查库
        }
    }

    /** 写列表缓存：值 + 基础 TTL + 随机抖动，防雪崩 */
    public void putListJson(String json) {
        if (redis == null || json == null) return;
        try {
            redis.opsForValue().set(LIST_KEY, json, listTtl());
        } catch (Exception ignored) { }
    }

    /** 成组失效：列表 + 单个详情 */
    public void evictListAndTrack(String trackSlug) {
        if (redis == null) return;
        try {
            redis.delete(LIST_KEY);
            if (trackSlug != null) {
                redis.delete(TRACK_KEY_PREFIX + trackSlug);
            }
        } catch (Exception ignored) { }
    }

    private Duration listTtl() {
        return BASE_TTL.plusSeconds(ThreadLocalRandom.current().nextLong(JITTER_SECONDS));
    }
}