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 延迟。
保持向前兼容
序列化对象应包含模式版本。新增字段要提供默认值,读取端应忽略未知字段;删除字段、改变类型或改变语义时,应升级键版本,不能让旧消费者误解新数据。
迁移期间应明确双读顺序、回填条件和停止旧写的时间点。不要长期保留双写,否则两套数据的失败组合会显著增加排障成本。
按自己的节奏,确认真正理解。