若依（RuoYi）框架性能核心：Redis 作用与场景全解析

// 若依字典缓存核心代码（com.ruoyi.system.service.impl.DictTypeServiceImpl）
@Override
public List<DictData> selectDictDataByType(String dictType) {
    // 1. 先查Redis缓存
    String key = CacheConstants.SYS_DICT_KEY + dictType;
    List<DictData> dictDataList = redisCache.getCacheObject(key);
    if (CollUtil.isNotEmpty(dictDataList)) {
        return dictDataList;
    }
    // 2. 缓存未命中，查数据库
    dictDataList = dictDataMapper.selectDictDataByType(dictType);
    // 3. 存入Redis，设置过期时间（避免缓存雪崩）
    redisCache.setCacheObject(key, dictDataList, CacheConstants.SYS_DICT_EXPIRE, TimeUnit.MINUTES);
    return dictDataList;
}

spring:
  session:
    store-type: redis # 会话存储到Redis
    timeout: 1800s # 会话超时时间（30分钟）
  redis:
    host: localhost
    port: 6379
    password: 123456
    database: 0 # 会话数据存0号库

// 若依分布式锁核心工具类（com.ruoyi.common.core.redis.RedisLockUtil）
public boolean tryLock(String lockKey, long timeout, TimeUnit unit) {
    String uuid = UUID.randomUUID().toString();
    // SET NX EX：不存在则设置，同时设置过期时间（避免死锁）
    Boolean success = redisTemplate.opsForValue().setIfAbsent(lockKey, uuid, timeout, unit);
    return Boolean.TRUE.equals(success);
}
// 业务中使用示例（定时任务防重复执行）
@Override
@Scheduled(cron = "0 0 1 * * ?")
public void syncData() {
    String lockKey = "sys:task:syncData";
    try {
        if (redisLockUtil.tryLock(lockKey, 5, TimeUnit.MINUTES)) {
            // 执行业务逻辑（同步数据）
        }
    } finally {
        // 释放锁
        redisLockUtil.unlock(lockKey);
    }
}

// 若依限流注解+Redis实现（com.ruoyi.common.annotation.RateLimiter）
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface RateLimiter {
    int limit() default 10; // 单位时间内最大请求数
    int time() default 60; // 时间窗口（秒）
    String key() default "sys:rateLimit:";
}
// 切面实现限流逻辑
@Around("@annotation(rateLimiter)")
public Object around(ProceedingJoinPoint point, RateLimiter rateLimiter) throws Throwable {
    String key = rateLimiter.key() + getIpAddress();
    // 1. Redis自增计数
    Long count = redisTemplate.opsForValue().increment(key, 1);
    // 2. 首次设置过期时间
    if (count == 1) {
        redisTemplate.expire(key, rateLimiter.time(), TimeUnit.SECONDS);
    }
    // 3. 超过限流阈值，拒绝请求
    if (count > rateLimiter.limit()) {
        throw new ServiceException("请求过于频繁，请稍后再试");
    }
    return point.proceed();
}
// 接口使用示例（登录接口限流）
@PostMapping("/login")
@RateLimiter(limit = 5, time = 60) // 60秒内最多5次登录请求
public AjaxResult login(@RequestBody LoginBody loginBody) {
    // 登录逻辑
}

<!-- Redis 核心依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<!-- 连接池（提升性能） -->
<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-pool2</artifactId>
</dependency>

spring:
  # Redis 基础配置
  redis:
    host: localhost # Redis地址
    port: 6379 # 端口
    password: 123456 # 密码（生产环境必填）
    database: 0 # 数据库编号（建议不同业务用不同库，如0：会话，1：缓存，2：锁）
    timeout: 10000ms # 连接超时时间
    # 连接池配置（性能优化核心）
    lettuce:
      pool:
        max-active: 8 # 最大活跃连接数
        max-idle: 8 # 最大空闲连接数
        min-idle: 0 # 最小空闲连接数
        max-wait: -1ms # 最大等待时间（-1表示无限制）
  # 会话存储到Redis（集群部署必开）
  session:
    store-type: redis
    timeout: 3600s

// com.ruoyi.framework.config.RedisConfig
@Bean
public RedisTemplate<String, Object> redisTemplate(LettuceConnectionFactory lettuceConnectionFactory) {
    RedisTemplate<String, Object> redisTemplate = new RedisTemplate<>();
    redisTemplate.setConnectionFactory(lettuceConnectionFactory);
    
    // 序列化配置（key：String，value：JSON）
    StringRedisSerializer stringRedisSerializer = new StringRedisSerializer();
    FastJsonRedisSerializer<Object> fastJsonRedisSerializer = new FastJsonRedisSerializer<>(Object.class);
    
    // key 序列化
    redisTemplate.setKeySerializer(stringRedisSerializer);
    redisTemplate.setHashKeySerializer(stringRedisSerializer);
    // value 序列化
    redisTemplate.setValueSerializer(fastJsonRedisSerializer);
    redisTemplate.setHashValueSerializer(fastJsonRedisSerializer);
    
    redisTemplate.afterPropertiesSet();
    return redisTemplate;
}