301重定向设置：小流量灰度如何暴露全量发布的例外
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /8fc5b56539fd.html
📄
301重定向设置：小流量灰度如何暴露全量发布的例外
灰度只覆盖部分入口时，它验证的是“规则对样本有效”，而不是“规则对全站有效”。301重定向设置真正容易在全量发布时出问题的，恰恰是灰度样本之外的那些例外：带参数的老链接、大小写变体、多级路径、以及被其他规则优先命中的URL。合理做法是：把灰度当成“找例外”的手段，而不是“证明没问题”的证据；先在一个可回滚的小范围内放量，记录哪些请求没有落到预期目标，再决定是补规则还是改规则顺序。
先明确灰度要验证的对象是什么
假设你手里有一份旧站URL清单，准备把其中一批迁到新路径。灰度阶段通常只挑“看起来最标准”的那几十条：无参数、单层路径、全小写。这样跑通并不难，难的是它掩盖了三类例外。
- 带参数的旧链接：
/old?id=123这类URL，如果规则只匹配路径不匹配查询串，可能被重定向到丢失参数的目标页。 - 大小写与结尾斜杠变体：
/Old/与/old在很多服务器配置下是两条不同规则，灰度若只测一种写法，另一种可能落到404。 - 被更高优先级规则截获的URL：新加的301规则如果排在旧的重写规则之后，请求会先被旧规则处理，永远到不了你新写的目标。
所以灰度的第一步不是“挑几条能过的”，而是“挑几条最可能不过的”。把清单按参数、层级、大小写分组，每组至少放一条进灰度，这样暴露的例外才有代表性。
灰度放量时该记录什么，而不是只看状态码
很多人灰度时只确认“返回301就算成功”，这不够。301只说明服务器给了跳转指令，不说明跳到了正确位置，也不说明后续请求链是否正常。建议在灰度期间记录三类信息：
- 源URL与目标URL的对应关系：逐条比对，确认没有把A页跳到B页这种错配。错配在小样本里往往只出现一两条，全量时会放大成一批。
- 跳转链长度：如果A跳到B、B又跳到C，说明规则之间有叠加。灰度时链长是2，全量后可能变成3甚至循环。
- 未命中规则的请求：这些是灰度最有价值的产出。它们告诉你规则覆盖的边界在哪里，而不是告诉你“已经好了”。
一个实际动作是：在灰度期间把未命中的源URL单独导出，逐条判断是“应该补一条规则”还是“这条URL本来就不该跳”。这个判断直接决定下一步是扩规则还是缩范围。
两种做法成立的条件与代价
面对灰度暴露的例外，通常有两种处理方向，它们成立的条件不同。
做法一：补例外规则，让覆盖更全。 当例外URL有明确、稳定的对应目标，且数量可控时适用。代价是规则集会变长，规则之间的优先级和匹配顺序更难维护，后续新增规则时更容易互相干扰。如果例外是带参数的动态URL，补规则往往需要正则或查询串匹配，测试成本明显上升。
做法二：收窄迁移范围，把例外排除在外。 当例外URL的目标不明确，或者它们本身流量极低、不值得为它们维护复杂规则时适用。代价是这些URL会保持原状或返回404，需要确认它们没有被外部引用、也没有历史价值。收窄的边界要写清楚，否则全量发布时又会有人把它们加回来。
选择依据可以归结为一句话：如果例外的目标能一句话说清且长期稳定，补规则；如果例外的目标需要逐条讨论，先排除。灰度阶段暴露的例外数量，本身就是判断该走哪条路的依据。
从灰度到全量，需要确认的发布条件
全量发布不是把灰度范围调大就结束。发布前至少要确认三件事：
- 规则顺序已固定：新301规则的位置是否在所有可能截获它的旧规则之前，这一点必须在灰度环境验证过，而不是靠读配置推断。
- 回滚路径可用：全量后发现例外比预期多时，能否快速退回灰度状态。回滚不是撤销所有规则，而是把放量范围收回到已验证的那部分。
- 例外清单已归档：灰度中判定“不迁移”的URL，要有一份明确记录，避免全量时被重复纳入。
发布后观察的重点不是“有没有301”，而是“有没有出现灰度中没见过的源URL类型”。如果出现，说明灰度的样本分组还不够，下一轮要把这类URL补进灰度集合。这个过程本身就是让规则逐步收敛，而不是一次性正确。
一个短例子说明假设下的比较方法
假设旧站有1000条URL，灰度抽了50条，其中3条未命中预期目标。若这3条都属于“带参数”这一类，那么可以推断全量中带参数的URL可能整体存在同类问题，需要先统计全站带参数URL的占比，再决定是补一条通用规则还是逐条处理。若这3条分属三种不同原因，说明规则本身的结构有问题，补例外只会越补越乱，此时更合理的动作是回到规则顺序和匹配条件上重新设计。这个推断是假设性的，目的是说明：灰度的价值在于把例外归类，而不是数它有几条。
把灰度结果按原因归类，再对照“目标是否明确、数量是否可控”这两个条件，就能判断该补规则还是该收窄范围，从而让全量发布建立在已验证的例外清单之上，而不是建立在样本跑通的假象之上。
