Redis 接口契约：序列化、TTL 与失败语义一次说清

Redis 接口契约：序列化、TTL 与失败语义一次说清

1. 键和值先定契约

Key 包含业务域、版本和稳定标识，避免把可变展示文本当主键。Value 的序列化格式要记录版本；升级字段时同时考虑旧数据读取，而不是依赖一次性清空缓存。

2. TTL 是业务语义

过期时间来自数据允许陈旧多久。批量写入可增加抖动，防止同一时刻集中失效，但随机范围要结合刷新能力设置。永久 Key 需要明确所有者和清理机制。

3. 失败要可区分

未命中、超时、连接失败和反序列化错误不能都返回 null。调用方需要据此决定查源、降级或报警。写操作若要求幂等，还要定义重复请求和部分成功的处理。

4. 限制批量操作

Pipeline 和 Lua 脚本都应有输入上限与超时预算。上线前用接近真实大小的 Key、Value 测试网络和 CPU，而不是只用空缓存跑吞吐。