Redis 与缓存 / 系统课时

设计缓存键与序列化格式

设计缓存键与序列化格式

本课解决缓存键难以检索、结构升级后新旧数据不兼容的问题。你将建立包含业务域、版本和对象标识的键名规则,并在 JSON、二进制协议和 Redis Hash 之间做出可维护的选择。

学习目标

  • 设计稳定且可升级的缓存键
  • 比较常见序列化格式的取舍
  • 使用版本化键名平滑迁移

设计稳定键名

推荐使用“业务域:版本:资源:标识”,例如 payhub:v2:merchant:{1001}:profile。固定前缀便于统计和治理,版本号隔离不兼容结构,末尾标识用于定位对象。

键名不要包含密码、证件号或银行卡号,也不要直接拼接超长查询参数。Redis Cluster 中花括号内容是哈希标签,只有确实需要多键落在同一槽位时才应使用,并避免把大量无关键集中到少数槽位。

写入版本化数据

下面的命令默认连接本机 Redis,为 v2 版本的商户资料写入 JSON,并设置 600 秒 TTL。

bash
redis-cli --raw SET 'payhub:v2:merchant:{1001}:profile' '{"merchantNo":"1001","status":"ACTIVE","schemaVersion":2}' EX 600
redis-cli --raw GET 'payhub:v2:merchant:{1001}:profile'

预期输出:

text
OK
{"merchantNo":"1001","status":"ACTIVE","schemaVersion":2}

升级到 v3 时,可以先读新键,未命中再读旧键并转换回填。迁移稳定后停止写入旧版本,等待旧键自然过期或按前缀受控清理。

选择序列化格式

方案 优点 主要代价
JSON String 可读、跨语言、排障方便 体积较大,通常整体更新
Protobuf 等二进制 紧凑、类型明确 需要模式文件和工具支持
Redis Hash 字段级读写方便 版本迁移和整体过期更复杂

JSON 适合开放对象和频繁排障场景;二进制格式适合高吞吐、强类型和带宽敏感场景;Hash 适合独立读取或更新少量字段。小对象通常不值得额外压缩,应使用真实样本测试体积、CPU 消耗和 P99 延迟。

保持向前兼容

序列化对象应包含模式版本。新增字段要提供默认值,读取端应忽略未知字段;删除字段、改变类型或改变语义时,应升级键版本,不能让旧消费者误解新数据。

迁移期间应明确双读顺序、回填条件和停止旧写的时间点。不要长期保留双写,否则两套数据的失败组合会显著增加排障成本。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计缓存键与序列化格式

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

登录哪都通