loan-pricing/doc/2026-04-15-DictUtils泛型告警修复后端实施记录.md

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 的未检查类型转换告警。