新模板别一次全量：目录站的灰度发布和那个必须能一键关掉的开关

目录站有个特点：页面数量多，但模板只有几套。改一次模板，几千个页面同时变脸。这个杠杆好处是效率高，坏处是出事也是几千个页面一起出事。

图片来源：网络，版权归原作者所有，侵权请联系删除

为什么目录站更需要灰度

内容站改模板，影响的是阅读体验；目录站改模板，影响的是链接、结构化数据、筛选逻辑这些跟收录直接相关的东西。一旦新版把某个字段漏掉了，爬虫下次抓取时看到的是成千上万个缺字段的页面，不是一两个。

全量上线的诱惑在于省事：改完发布，一了百了。但目录站的页面结构一旦被爬虫重新学习，改回来还得再学一遍，这中间的波动期短则一周。灰度不能消灭风险，它能把风险限制在一小批页面上。

开关的三种粒度

粒度	适合什么	成本
全站单开关	改版、换模板	最低，一个配置项
按分类或页面类型	新列表页样式	中等，需要一个匹配规则
按用户或流量比例	交互功能、排序逻辑	较高，要保持会话一致

第二种对目录站最实用：先在两个分类上开新版，观察一周再铺开。分类是天然的分组，出问题影响面可控，也容易定位。

第三种有个坑：同一个人两次访问落到不同版本，体验割裂，数据也没法看。要按用户或会话做稳定分桶，别用随机数。

分批放量怎么走

常见的节奏是三档：小比例试一天、中比例跑两三天、全量。每一档之间要有明确的检查项，而不是看一眼没报错就继续：

• 小比例阶段看的是报错率和核心指标——页面 5xx、渲染失败、关键字段缺失。
• 中比例阶段看的是数据——点击分布有没有突变、停留时间、零结果率。
• 全量阶段看的是收录侧——抓取量、索引状态、有没有新增的结构化数据报错。

这三档的检查项提前写下来。上线时凭印象判断，几乎一定会跳过第二档。

切换期最怕的是不一致

同一批页面一半新版一半旧版，对爬虫来说是个麻烦事。要守住三条：

• canonical 前后一致。新版改了 URL 结构，canonical 必须还指向同一个规范地址，否则爬虫会以为你在搞两套。
• 结构化数据不能一会儿有一会儿没有。要么新旧都有，要么都先别放，别让新版独有。
• 一次切换要整页切。同一个页面里上半截用新模板、下半截用旧模板，这种拼接出来的页面爬虫最难理解。

换句话说，灰度可以按页面分组，不要按页面内的模块分组。一个页面要么新要么旧，别搞混合。

回滚条件提前写死

上线前就把阈值定下来：5xx 超过某个比例、关键字段缺失率超过千分之几、点击率掉超过一成，触发回滚。这些数字写进发布单，到了现场就不用争论「这是不是正常波动」。

回滚本身要能做到一个动作完成。如果需要手动改三处配置、清两次缓存，那就等于没有回滚。开关存在的意义就是这个：出事时先把功能关掉，再慢慢查原因。

开关要清理

灰度结束、功能稳定之后，把开关和旧代码分支删掉。留着的开关会变成没人敢动的死代码，半年后新人看到两套模板逻辑，不知道该信哪个。给每个开关记一条创建时间和预计清理时间，到期就清。