索引升级灰度：验证兼容性，也验证回退

索引升级灰度验证兼容性也验证回退灰度索引不是只看新算法是否更快。新旧索引的 key 编码、缺失值、排序规则和边界行为都可能不兼容。上线前先确定回退索引仍可独立服务预测索引给出越界位置时应回退到传统查找并记录原因。影子对比优先用于读请求。对写路径双写需要明确定义顺序、幂等键、失败补偿和数据修复策略否则“双写”本身会制造不一致。idx, ok : predictedIndex(key) if !ok || idx 0 || idx len(items) { return tree.Lookup(key) } return probeAround(items, idx, key)灰度按稳定键分流保留快速关闭开关。监控差异率、回退率、错误类别和真实数据中的异常 key不要把灰度放量等同于性能基准测试。每一步扩大流量前都应有阈值和回滚演练。兼容性先于命中率新索引在离线数据上命中更高不代表可以直接替换旧索引。比如新实现把空字符串归一化而旧实现保留原值或者两套索引对相同 key 的排序规则不同。调用方如果依赖第一个结果就可能在没有报错的情况下改变行为。灰度前要列出这些契约并准备覆盖空值、重复 key、最大长度和编码差异的样本。probeAround也有适用前提预测位置附近必须存在可定义的查找窗口。若预测模型失效、数据分布突变或索引还未构建完成应回到tree.Lookup而不是扩大探测范围直到拖慢整个请求。回退路径要和主路径一样可观测否则只会把错误变成延迟。双写不是默认答案写路径双写时一个存储成功、另一个失败是常态而不是例外。需要有幂等标识、补偿任务和可重放的变更记录才能修复差异。对不能承受短暂不一致的业务更适合先从变更日志构建新索引再在一致性检查通过后切读。验证可分三层离线比较同一批 key 的结果影子读取只记录差异小比例真实流量切读并随时关闭。每层的继续条件要事先写清楚例如出现新的错误类别就停止放量并保留现场信息。3. 差异日志要能指导修复影子对比记录“不同”还不够。至少要区分是召回集合不同、排序不同、字段缺失还是新索引根本没有准备好同时记录索引版本、请求类型和可脱敏的 key 特征。否则差异一多只能看到一个比例无法判断该改构建逻辑还是改兼容层。差异样本不应无限保存。先按错误类别聚合再为每类保留少量可复现的样本避免日志反过来成为压力来源。修复后用同一批样本回放确认差异确实消失。这个闭环比持续扩大流量更能说明新索引是否已经可用。4. 切换读取前先确认数据新鲜度即使新旧索引结果一致也可能读的是不同时间点的数据。索引构建延迟、增量同步失败或分区滞后都会让新路径返回旧结果。灰度指标里应有数据版本或水位信息异常时先判断是否是新鲜度问题而不是把它归为检索质量下降。切读开关最好和版本绑定。关闭开关后旧索引应立即成为唯一读源后台构建仍可继续但不能影响线上结果。把这个动作在预发布环境演练一遍能确认所谓回退不是只改了一个配置名。切换记录还应包含生效时间和负责人员。发生争议时团队能查到某个结果究竟来自哪套索引而不是依靠记忆判断。