升鲜宝生鲜配送供应链管理系统--- 《多语言商品查询优化方案（Redis + 翻译表 + 模糊匹配）》

升鲜宝生鲜配送供应链管理系统--- 《多语言商品查询优化方案（Redis + 翻译表 + 模糊匹配）》
一、方案概述

本方案旨在实现商品模块的多语言查询与显示一体化。通过结合 Redis 缓存与数据库翻译表（sys_dynamic_translation），实现以下目标：

1. 用户可根据当前语言环境进行多语言关键词搜索。
2. 查询结果自动返回对应语言的名称与属性。
3. 优先从 Redis 读取翻译缓存，无缓存则从数据库读取并写回 Redis。

二、查询流程图

用户输入 keyword="Salmon"
│
▼
Redis hGetAll("i18n:pms_goods:en-US")
│ 命中 → [1001]
▼
WHERE goods_id IN (1001)
│
▼
数据库分页查询 pms_goods 表
│
▼
结果 → 显示 goodsName=Salmon（Redis翻译值）

三、Redis Key 结构
模块 Redis Key 示例 结构 缓存字段
商品信息 i18n:pms_goods:{lang} Hash<goodsId, goodsName> goodsName, goodsMaterial
品牌信息 i18n:pms_brand:{lang} Hash<brandId, brandName> brandName
分类信息 i18n:pms_goods_category:{lang} Hash<categoryId, categoryName> categoryName
材质信息 i18n:pms_goods_material:{lang} Hash<materialId, materialName> materialName
单位信息 i18n:pms_goods_unit:{lang} Hash<unitId, unitName> unitName
规格信息 i18n:pms_goods_sku:{lang} Hash<skuId, skuName> skuName
四、多语言匹配代码模板
以下为多语言模糊查询模板代码示例：

String lang = LanguageContextHolder.getLanguage();
String keyword = query.getGoodsName();

if (StringUtils.isNotBlank(keyword)) {
List matchedIds = new ArrayList<>();
String redisKey = "i18n:pms_goods:" + lang;
Map<String, Object> allTranslations = redisUtils.hGetAll(redisKey);

// ① 优先从 Redis 匹配
if (MapUtils.isNotEmpty(allTranslations)) {for (Map.Entry<String, Object> entry : allTranslations.entrySet()) {if (entry.getValue() != null && entry.getValue().toString().toLowerCase().contains(keyword.toLowerCase())) {matchedIds.add(Long.valueOf(entry.getKey()));}}
}// ② Redis 无 → 查数据库
if (matchedIds.isEmpty()) {List<SysDynamicTranslationEntity> translations =sysDynamicTranslationService.selectSysDynamicTranslationListByFieldValueLike("pms_goods", lang, "goodsName", keyword);if (CollectionUtils.isNotEmpty(translations)) {matchedIds = translations.stream().map(SysDynamicTranslationEntity::getEntityId).distinct().collect(Collectors.toList());}
}// ③ 将匹配结果加入查询条件
if (CollectionUtils.isNotEmpty(matchedIds)) {query.getEntityIdList().addAll(matchedIds);
}

}

五、查询与显示一体化方案（伪代码）

// Step 1: 处理查询条件
List matchedIds = i18nMatchService.findEntityIdsByKeyword("pms_goods", "goodsName", query.getGoodsName(), lang);
if (!matchedIds.isEmpty()) {
query.getEntityIdList().addAll(matchedIds);
}

// Step 2: 执行分页查询
List goodsList = pmsGoodsDao.findPmsGoodsNewPage(query);

// Step 3: 国际化字段填充
for (RespPmsGoodsPageNewDTO dto : goodsList) {
dto.fillI18nFields(redisUtils, sysDynamicTranslationService);
}

// Step 4: 返回分页结果
return new PageData<>(goodsList, page.getTotal());

六、性能优化要点

1. Redis 命中率高，查询性能提升 10~20 倍。
2. 模糊匹配优先 Redis，避免频繁 SQL 查询。
3. 缓存更新机制：新增/修改商品、品牌、分类时自动更新对应语言缓存。
4. 支持所有模块（品牌、分类、材质、单位）通用复用。
5. 降级策略：Redis 不命中时自动回退数据库翻译表。