# DictUtils 泛型告警修复后端实施记录

## 变更时间
- 2026-04-15

## 变更范围
- `ruoyi-common/src/main/java/com/ruoyi/common/utils/DictUtils.java`
- `ruoyi-common/src/test/java/com/ruoyi/common/utils/DictUtilsTest.java`

## 变更内容
- 修复 `DictUtils#getDictCache` 中对缓存对象直接强转 `List<SysDictData>` 触发的未检查类型转换告警。
- 调整缓存读取顺序，优先处理 `JSONArray`，避免 JSON 数组被 `List` 分支提前命中后返回非 `SysDictData` 元素。
- 对普通 `List` 缓存执行逐项类型校验并复制为强类型结果列表。
- 新增 `JSONArray` 缓存场景测试，覆盖字典缓存反序列化读取逻辑。

## 验证结果
- 执行 `mvn -pl ruoyi-common -Dtest=DictUtilsTest test`，测试通过。
- 执行 `mvn -pl ruoyi-common -am clean compile`，编译通过，未再出现 `DictUtils.java` 的未检查类型转换告警。