这篇文章拆解的是执行链断点,讲的是怎么一步步排查。我先说说上个月碰到的一个事儿。有个做教育投放的团队,发了段日志截图过来,说规则链里那条冷门词分支,明明显示命中了,计数也涨了,可访客落地页死活停在默认版本上。他们第一反应是“规则没生效”,掉头去改条件表达式,改了两轮,反倒把原本正常的分支也搞乱了。其实问题根本不在条件判断上——日志里命中标记和动作执行是两段独立记录,前者有,后者空着。这就是典型的“规则命中、动作丢失”:求值层走通了,执行层没接住。这种毛病,要是按“规则不准”的思路去调条件,方向从开头就偏了。
先分清:命中日志和动作执行是不是同一条链路
不少人把“命中”当成一个原子事件,其实在大多数跳转系统的实现里,它至少跨了三层。一层是条件求值,规则引擎遍历条件组,返回布尔结果和命中的规则 ID。再一层是上下文传递,把这条规则绑的动作参数——目标 URL、跳转方式、响应头——从规则配置里取出来,塞进当前请求的执行上下文。到第三层,才是执行器真正发起跳转或者改写响应。
动作丢失,意思是第一层给了结果,第二层或第三层断了。所以排查第一步,别急着看条件写得对不对,先确认日志里“命中”和“执行”是不是同一个请求 ID 下的两条记录。
- 命中记录有、执行记录完全没有,断点在上下文传递或执行器调用之前
- 执行记录有、状态是失败,断点在执行器内部,比如目标地址为空、跳转方式不支持
- 两条记录都正常、访客却没跳,那就得往响应输出层查,可能被缓存或前置代理吃掉了
这个判断做出来,后面能缩掉一大半排查范围。
上下文传递断点:动作参数在哪一步被丢掉了
上下文丢失是动作丢失里最常见、也最隐蔽的一类。规则命中了,可执行器拿到的动作对象是空的,或者关键字段是默认值。
条件分组嵌套时的作用域问题
规则链要是做了条件分组,每组可能带自己的局部上下文。命中发生在内层分组、而动作配置挂在外层规则上时,取动作参数的作用域如果没有正确向上回溯,执行器就会拿到一个空动作。表现就是命中计数正常、跳转不发生。
排查方法很直接:在求值返回和执行器入口各打一条带规则 ID 和动作摘要的日志,比对两处的动作对象是否一致。不一致,就是作用域回溯的问题,得检查分组配置里动作继承的开关有没有打开。
默认值覆盖了显式配置
另一种情况更气人:动作参数配了,执行时却被默认值盖掉。典型场景是规则里只配了目标 URL,没配跳转方式,执行器读到空的跳转方式后回退到默认的“不跳转”。这种默认值设计本意是保护,结果把显式意图吞了。
处理方式是给动作对象加一个必填校验:目标地址和跳转方式任一为空时,求值阶段就直接报配置错误,别留到执行阶段静默回退。配置校验前置,比事后查日志省事得多。
执行器侧断点:命中之后为什么没发出去
上下文没问题,动作对象也完整,跳转还是没发生,那就轮到执行器本身了。
动作覆盖顺序
一个请求可能同时命中多条规则,每条都带动作。执行器按优先级依次处理时,后执行的动作可能把前面的覆盖掉。如果高优先级那条动作是“保持当前页”,低优先级的目标 URL 就被压住了。这类覆盖冲突在规则链动作串行的场景里很常见,规则链条件命中后动作串行那篇拆过具体的覆盖链路,可以对照看。
判断依据是执行日志里同一请求 ID 下出现了多条动作记录,最后一条的动作类型决定了实际结果。跳转动作如果涉及回源或远程校验,可能触发超时预算。超时后执行器走降级路径,返回默认页而不报错。日志上看起来就是“动作执行了但结果无效”。这类问题要去看执行耗时字段,如果接近配置的超时阈值,基本可以确认。
顺带说一句,超时预算的分配本身也有讲究,代理层等待和后端等待要分开算,跳转超时预算怎么分配里有更细的拆解。
一个双行业混投的复盘:命中率正常但落地页不动
某团队同时跑金融和教育两条线,共用一套规则库。运营反馈教育线的冷门词分支“点了没反应”,但后台命中计数每天涨一千多。
第一步比对日志,命中记录有、执行记录缺失,断点定位在上下文传递。第二步查分组配置,发现教育线的规则挂在二级分组下,而动作参数配在父级,分组的作用域回溯开关因为一次配置调整被关掉了。金融线因为规则是平铺的,没受影响,所以问题只暴露在教育线。
修复动作是把作用域回溯重新打开,同时在求值出口加了一条动作对象非空校验。上线后观察两天,命中计数和执行计数对上了,落地页版本切换恢复正常。这个案例的教训是:规则库共用时,分组结构的改动影响面比想象中大,改完要做跨线的回归验证。
排查顺序小结
动作丢失的排查,建议按这个顺序走,每步都有明确的判断依据:
- 比对命中日志与执行日志是否同一请求 ID、是否成对出现
- 检查动作对象在求值出口和执行器入口是否一致,定位上下文丢失
- 核对动作参数的必填项,排除默认值回退
- 查看执行日志的动作覆盖顺序,排除高优先级动作压制
- 检查执行耗时是否触达超时阈值,排除静默降级
这套顺序的价值在于每一步都能独立收敛一部分原因,不用来回翻配置。规则本身的正确性放到最后再验证,因为大部分“命中不跳转”的根因根本不在条件表达式上。
常见问题
规则命中计数正常,但访客完全没跳转,最先查什么?
先查命中日志和执行日志是不是同一个请求 ID 下成对出现的两条记录。如果只有命中没有执行,问题在上下文传递或执行器调用之前,跟条件写得对不对没关系。这个判断能帮你省掉大量调条件的时间。
动作参数配了却被默认值覆盖,怎么避免?
说白了就是配置校验没前置。把目标地址和跳转方式的非空校验放到求值阶段,配错了直接报错,别留到执行阶段静默回退。另外默认值的设计要想清楚,保护性默认有时候反而会吞掉显式意图。
多条规则同时命中时,动作丢失是覆盖导致的吗?
这个要看情况。同一请求下如果执行日志里出现多条动作记录,最后一条的类型决定了实际结果,那基本就是覆盖。如果只有一条动作记录但没执行成功,更可能是上下文或超时的问题。先看日志里动作记录的条数再下结论。
延伸阅读
本文讲的是动作丢失在规则链内部的断点定位,如果跳转链路还依赖了第三方 JS 脚本,阻塞和加载时序会引入另一类断点,下面这篇从加载时序到回退边界给出了完整的检查框架:第三方JS阻塞时依赖梳理顺序