若依框架中字典数据缓存未生效？

Question

在使用若依（RuoYi）框架时，常有开发者反馈字典数据缓存未生效问题：系统在启用了Redis或本地缓存的情况下，仍频繁查询字典表（sys_dict_data），导致数据库压力增大、响应变慢。该问题通常源于字典工具类（DictUtils）未正确调用缓存机制，或缓存键生成策略不合理，造成缓存写入与读取不一致。此外，部分模块直接通过Service层查询字典数据，绕过了缓存处理逻辑，也是常见原因。需检查缓存配置、工具类调用方式及是否在事务中修改字典后未及时刷新缓存。

Answer 1

一、问题现象与初步排查

在使用若依（RuoYi）框架开发过程中，许多开发者反馈即使启用了Redis或本地缓存（如Caffeine），系统仍频繁访问sys_dict_data字典表，导致数据库负载升高、接口响应延迟。该现象通常表现为：

• 每次请求字典数据时，SQL日志中均出现对sys_dict_data的查询语句；
• Redis监控工具未观察到相关缓存键写入；
• 通过@Cacheable注解标记的方法未命中缓存。

初步排查应从以下三个方向入手：

1. 确认全局缓存配置是否启用并正确加载；
2. 检查DictUtils工具类是否调用了缓存读取逻辑；
3. 验证是否存在绕过工具类直接调用Service查询的情况。

二、缓存机制原理与若依框架集成方式

若依框架默认采用Spring Cache抽象层进行缓存管理，支持多种实现如Redis、Ehcache、Caffeine等。其核心组件包括：

组件	作用
@EnableCaching	开启Spring缓存功能
@Cacheable	标识方法结果可缓存
CacheManager	管理具体缓存实现实例
RedisTemplate	Redis操作模板

在DictUtils中，标准做法是通过@Cacheable(value = "dict", key = "#type")缓存字典项列表，但若键生成策略不一致或未启用AOP代理，则可能导致缓存失效。

三、常见问题根因分析

通过对多个项目案例的分析，字典缓存未生效的主要原因如下：

• 缓存配置缺失或错误：application.yml中未配置spring.cache.type或Redis连接信息不完整；
• 工具类调用方式不当：在同一个类中直接调用DictUtils.getDictCache(type)，由于Spring AOP代理限制，无法触发@Cacheable增强；
• 缓存键生成不合理：例如使用了对象实例作为key，导致哈希不一致；
• 绕过缓存逻辑：部分模块直接调用SysDictDataService.selectDictDataList()，未经过DictUtils封装层；
• 事务中修改未刷新缓存：更新字典后未执行@CacheEvict清除旧数据，造成脏读。

四、解决方案与最佳实践

针对上述问题，提出以下分层解决策略：

1. 确保主启动类添加@EnableCaching注解；
2. 在DictUtils中使用静态代理模式调用自身缓存方法，避免自调用失效问题；
3. 统一所有字典查询入口为DictUtils.getDictLabel()或getDictValues()；
4. 定义标准化缓存键生成器，示例如下：

public class DictKeyGenerator implements KeyGenerator {
        @Override
        public Object generate(Object target, Method method, Object... params) {
            StringBuilder key = new StringBuilder(method.getName());
            for (Object param : params) {
                key.append(":").append(param.toString());
            }
            return key.toString();
        }
    }

并在配置类中注册：

@Configuration
@EnableCaching
public class CacheConfig {
    @Bean
    public KeyGenerator dictKeyGenerator() {
        return new DictKeyGenerator();
    }
}

五、流程图：字典缓存调用路径对比

以下为正常与异常调用路径的Mermaid流程图对比：

正确路径（走缓存）

graph TD
    A[Controller] --> B{调用DictUtils.getDictLabel()}
    B --> C[DictUtils委托Spring Cache]
    C --> D{缓存命中?}
    D -- 是 --> E[返回缓存值]
    D -- 否 --> F[查数据库并写入缓存]
    F --> G[返回结果]
    

错误路径（绕过缓存）

graph TD
    H[Controller] --> I[直接调用SysDictDataService.list()]
    I --> J[执行SQL查询sys_dict_data]
    J --> K[返回结果，无缓存]
    

六、监控与验证手段

为确保缓存机制真正生效，建议采取以下验证措施：

• 开启Redis慢查询日志，监控高频访问的key；
• 使用Spring Boot Actuator暴露/cache-manager端点查看缓存状态；
• 在DictUtils中添加日志输出，记录缓存命中情况；
• 通过JMH基准测试对比缓存开启前后QPS变化；
• 利用Arthas动态追踪@Cacheable方法的调用栈。

例如添加日志：

if (StringUtils.isEmpty(cacheValue)) {
        log.warn("字典缓存未命中，type={}", type);
        // 查询DB并放入缓存
    }