Redis Key 命名规范文档（含图表与命名规则）
一、命名规范与结构说明
统一 Redis Key 命名规范有助于：
✅ 快速定位缓存来源模块
✅ 避免 Key 冲突与重复写入
✅ 支持多语言、多租户缓存隔离
✅ 方便统一监控与清理
命名结构：模块:子模块:业务:实体[:主键或语言]
组成部分 示例值 说明
模块 pms 产品模块，如 sys、mall、pms、wms、i18n
子模块 brand 品牌、分类、库存等子模块
业务 data / list / index 数据类型或业务功能
实体 id / lang 主键或语言代码，如 en-US
示例：
i18n:pms_brand:1001:en-US
sys:user:permissions:9527
二、模块命名约定
模块 命名空间前缀
系统模块 sys:
商城模块 mall:
产品模块 pms:
仓储模块 wms:
国际化模块 i18n:
供应链模块 scm:
三、常用 Key 示例
Key 名称 示例 类型 说明
系统验证码 sys:captcha:{uuid} String 验证码缓存（5分钟）
用户权限 sys:user:permissions:{id} Hash 用户权限缓存（24小时）
品牌信息 pms:brand:{id} String 品牌主信息（默认语言）
品牌国际化 i18n:pms_brand:{id}:{lang} Hash 品牌多语言缓存（按语言分离）
商品数据 pms:goods:data:{lang} Hash 商品信息（含翻译）
库存快照 wms:inv:snapshot:{warehouseId} Hash 仓库库存快照（6小时）
四、Key 生命周期建议
类型 过期时间 说明
临时缓存（验证码） 5-30分钟 短期缓存，防止重放攻击
分页结果缓存 10分钟 列表页/分页结果
品牌与商品缓存 24小时 基础主数据
多语言缓存 24小时 每语言单独缓存
库存快照 6小时 动态数据定期刷新
五、命名层级结构图
sys
├── captcha:{uuid}
├── user:permissions:{id}
pms
├── brand:{id}
├── goods:data:{lang}
│ ├── category:{cid}
│ └── brand:{bid}
└── sku:list
i18n
├── pms_brand:{id}:{lang}
└── pms_category:{id}:{lang}
六、规范总结
1️⃣ Key 全小写，使用 ":" 分隔层级
2️⃣ 层级不超过 5 级，保证查询性能
3️⃣ 多语言字段需带 lang 后缀
4️⃣ 类型与结构在命名中体现（如 list、data）
5️⃣ 模块前缀唯一对应业务系统
