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️⃣ 模塊前綴唯一對應業務系統