架构之道 · 字段新增与缓存契约
排序接口要新增两个通用属性:状态标识码 statusCode 与配置类型 configType。它们不存本地库,由上游基础数据微服务统一维护,因此这次改动需要跨服务取数,牵出 JSON 序列化与 RPC 两条链路。
需求背景
statusCode 表示数据项状态(ACTIVE / PENDING / DISABLED),configType 表示业务配置类型(TYPE_A / TYPE_B),两者都由上游基础数据微服务维护,不在本服务本地库,只能跨服务获取。
新增字段本来就是向后兼容的
服务端把响应对象(VO)序列化成 JSON 再返回给客户端(Web、iOS、Android、小程序)。客户端反序列化时会忽略未定义的未知字段,所以新增字段对旧客户端天然兼容,不需要强制升级。
// 变更前
{ "id": 1, "name": "示例项" }
// 变更后:旧客户端自动忽略未知字段
{ "id": 1, "name": "示例项", "statusCode": "ACTIVE", "configType": "TYPE_A" }只有修改已有字段的类型、重命名字段或删除字段,才是破坏性变更,必须和客户端同步。
跨服务取数:RPC 做了什么
新字段通过 RPC 框架(如 Dubbo、gRPC)跨服务获取。本地写一行调用,体验像本地函数,底层却完成了参数序列化、网络传输、对端反序列化并执行、结果序列化回传、本地反序列化五步。
List<BaseItem> list = iBaseDataMicroService.queryAllList();多路径组装一致性
为了提速,组装通常分两条路径:命中缓存时直接取名称,未命中时穿透查询多语言服务并回写缓存。若只在未命中分支补充新字段,命中分支遗漏,Jackson 就会把缺失字段序列化成 null,表现为“时有时无”的随机 Bug。
// 反面:只在未命中分支补字段
if (cachedName != null) {
vo.setDisplayName(cachedName); // 命中:新字段缺失
} else {
vo.setDisplayName(rpc.getDisplayName());
vo.setStatusCode(rpc.getStatusCode()); // 未命中:字段齐全
vo.setConfigType(rpc.getConfigType());
}
// 正面:分支只决定数据来源,组装收敛到一处
String name = cachedName != null ? cachedName : rpc.getDisplayName();
return assembleVo(rpc, name);- 未命中路径
- 补齐了 statusCode 与 configType,首个请求正常
- 命中路径
- 只取缓存名称,遗漏新字段赋值,Jackson 序列化为 null
- 线上表现
- 缓存生成后字段突然变 null,Bug 随机出现,难以排查
缓存为何只存多语言
不同字段的变更频率与查询成本不同:多语言译名涉及跨服务字典表查询,开销大、频率高但内容稳定,适合缓存;基础属性随 RPC 主列表直接返回,无需二次查询,不必占用 Redis。失效采用“比对式校验”:只比对记录条数与主键 ID 集合是否与最新列表一致,不比对译名文本,也未配置 TTL。
演进与接入
补救办法有两种:给缓存加 TTL,到期自动重建;或在数据变更时用消息队列(Kafka / RocketMQ)发事件,主动清除对应 Key。对前端而言,本次升级零破坏性变更:statusCode 按契约映射为 UI 状态,configType 用于逻辑判断或透传下游。
本文属于 无魔法工程流派 的第 9 篇肉身实战。
发表评论
分享你的想法和反馈