Redis 与缓存 / 系统课时

设计稳定的键名

设计稳定的键名

本课解决 Redis 键名随业务增长而混乱的问题。你将建立可读、可搜索、可演进的命名规则,并能从键名快速判断环境、业务归属、对象类型和唯一标识。

学习目标

  • 使用分层结构设计稳定且唯一的键名
  • 避免命名冲突、隐私泄露和过长键名
  • 为环境隔离和不兼容升级预留清晰边界

用分层结构表达业务含义

Redis 不限制键名格式,工程中通常使用冒号分隔层级。推荐按“环境、业务域、对象类型、稳定标识、用途”组织,但只保留当前系统真正需要的层级。

text
prod:pay:order:202607300001:status
prod:user:1001:profile
prod:user:1001:session

环境已通过独立 Redis 实例隔离时,可以省略 prod:;多个环境共享实例时,应显式加入环境前缀,避免测试数据覆盖生产数据。最左侧层级应稳定,便于按前缀统计、迁移和排查。

Redis 稳定键名组成结构图

选择稳定且无敏感信息的标识

对象标识应优先使用数据库主键、订单号或设备编号等稳定值。用户名、门店名称、手机号和邮箱可能变化,也可能泄露隐私,不宜直接出现在键名中。

不推荐使用 user:alice@example.com、merchant:北京一店 或 order:current。前两者包含可变或敏感内容,后者无法在并发场景中唯一定位订单。更稳妥的形式是 user:1001、merchant:880021 和 order:202607300001。

控制长度与版本

键名本身会占用内存,并参与网络传输、持久化和复制。不要把完整 JSON、长 URL 或描述性句子塞进键名;可读性足够即可,不必重复已经由层级表达的信息。

当数据结构发生不兼容变化时,可以增加短版本段,例如 user:v2:1001:profile。版本只用于需要并行迁移或灰度切换的结构变化,普通字段调整不应频繁创建新版本。

验证命名规则

下面写入两个订单状态键,再用 SCAN 验证业务前缀、对象类型、标识和用途是否清晰。

bash
redis-cli MSET prod:pay:order:202607300001:status PAID prod:pay:order:202607300002:status PENDING
redis-cli SCAN 0 MATCH 'prod:pay:order:*:status' COUNT 100

预期输出:

text
OK
1) "<NEXT_CURSOR>"
2) 1) "prod:pay:order:202607300001:status"
   2) "prod:pay:order:202607300002:status"

<NEXT_CURSOR>、返回顺序和单批数量可能不同。SCAN 是增量遍历命令;生产环境不要使用 KEYS prod:pay:order:* 扫描大型键空间。

落地为统一生成规则

团队应在代码中集中生成键名,不要让各模块自由拼接字符串。创建新键前至少检查:业务域是否明确、标识是否稳定唯一、是否含敏感信息、是否需要环境或版本层级。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

设计稳定的键名

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通