
先把“变量当字符串拼”这个习惯掰过来
上个月有个做家居流量站的客户找过来,说跳转插件的规则配的是“地区是华东且设备是移动端才走B页”,结果线上跑出来一批华东的桌面端流量也进了B页。他们第一反应是插件有bug。把规则导出来一看,地区变量直接和“华东”做等值比较,设备变量直接和“mobile”做等值比较,两个条件用加号连在一起。问题出在写法上,跟插件关系不大——他们把内置变量当普通文本在拼,既没确认变量的实际取值形态,也没管运算符在表达式里怎么结合。
这是跳转插件条件分支里最常见的一类坑。内置变量看着是“一个字段”,实际取值可能是字符串,可能是数组,可能是带默认值的枚举,也可能是空。写表达式的人要是不先把变量的取值语义确认清楚,写出来的条件语法上能过,语义上早就偏了。下面按变量语义、类型与空值、优先级、短路顺序、嵌套控制和验证顺序几个层面拆开讲,重点是让规则出问题时能被快速定位,别靠猜。
内置变量的取值语义要先确认,再动笔
跳转插件一般会暴露几类内置变量:请求侧的地区、设备类型、来源渠道、UA特征、访问时间、频次计数,还有业务侧配置的渠道标识、活动编号等。每一类变量的取值形态不一样,动笔之前得先把三件事确认清楚。
取值是单值还是多值
地区变量在多数插件里是单值字符串,但来源渠道、标签类变量经常是数组或者逗号分隔的多值。单值变量写等值比较没问题;多值变量直接写等值比较,语义上就变成了“整个数组等于某个字符串”,几乎永远为假。多值变量要用包含判断,等值判断在这里是不对的。这一步没确认,规则会表现为“条件写了但从不命中”,排查时又因为表达式语法没报错而查不到方向。
设备类型这类变量,有的插件返回“Mobile”,有的返回“mobile”,有的还带前后空格。表达式里写死小写,遇到返回大写的环境就全部判假。规范做法是在表达式层面统一做归一化,或者在规则配置里约定变量输出前已经做过小写化和去空格处理。这个约定要写进规则文档,不能靠写规则的人各自记忆。
缺值时的默认形态
变量取不到值时,插件可能返回空字符串、null、undefined 或者一个约定的占位值。这四种形态在表达式里的行为完全不同:空字符串参与等值比较会得到“不等于任何非空值”,null 参与某些比较可能直接抛错,也可能整体判假。写表达式前要确认插件对缺值的处理约定,需要的地方显式做空值判断,别假设变量一定有值。
类型与空值处理:表达式写错一半都出在这里
条件分支表达式出问题,类型和空值占了大头。下面几类写法要按规范收敛。
- 字符串比较统一用显式等值或包含判断,不要依赖隐式类型转换。数字型变量(比如频次计数)做大小比较前,确认变量返回的是数字而不是字符串,字符串形态的“10”和数字10在部分表达式引擎里比较结果不一致。
- 空值判断要前置。对可能为空的变量,先判空再参与业务比较,避免“空值恰好满足某个宽松条件”导致误命中。比如频次变量为空时,某些引擎会当成0处理,结果所有首次访问都被判进“频次小于阈值”的分支。
- 多值变量的包含判断要确认匹配方式: 是完全匹配某一项,还是子串匹配。子串匹配容易把“华东”匹配进“华东新区”这类值里,造成边界外的流量被吸进来。
- 布尔型变量不要和字符串“true”直接比较,按插件约定的布尔语义写。
这些规范看着琐碎,但每一条都对应一类线上能观察到的异常:条件从不命中、条件过度命中、边界值漂移。把它们写成规则书写约定,比事后一条条排查省事得多。
运算符优先级与短路求值:顺序错了结果就反了
条件分支表达式里同时出现“与”“或”“非”时,优先级决定实际判定顺序。多数表达式引擎里“非”优先于“与”,“与”优先于“或”,但这个顺序不是所有插件都一致,尤其是插件自带的简化表达式语法。写多条件表达式时,别依赖记忆中的优先级,用括号把每一组条件显式分组。
短路求值同样影响结果和排查。多数引擎在“与”表达式里遇到第一个假值就停止后续求值,在“或”表达式里遇到第一个真值就停止。这带来两个实际影响:一是把开销大的判断放在后面,可以减少不必要的计算;二是如果某个变量在短路后没有被求值,它的缺值或异常就不会暴露,规则看起来正常,换个流量顺序就出问题。规范做法是把可能缺值、可能异常的判断放在前面并显式处理,把稳定的业务判断放在后面。
还有一个容易忽略的点:同一表达式里对同一变量做多次判断时,确认这几次判断之间变量没有被中间逻辑改写。跳转插件的变量一般在一次判定内是稳定的,但如果规则链里有多级跳转或变量重写,就要确认判定时读到的是哪一版值。
嵌套深度与分支数量:能平铺就不要嵌套
条件分支写深了,排查成本会指数上升。三层以上的嵌套,出问题时很难一眼看出是哪一层的哪个条件判错了。规范上建议把嵌套控制在两层以内,超过的部分拆成多条独立规则,用规则优先级来组织判定顺序,而不是在一个表达式里层层套。
分支数量也要控制。一个表达式里塞十几个“或”条件,命中结果无法归因,日志里只能看到“命中了这条规则”,看不出是哪个子条件起的作用。可行的做法是按业务语义拆分规则组:地区一组、设备一组、渠道一组,每组规则只负责一类判断,组间用优先级衔接。这样出问题时,先定位到组,再定位到组内规则,排查路径是收敛的。
拆规则时要注意规则之间的互斥与覆盖关系。平铺出来的多条规则如果条件有重叠,命中顺序就依赖优先级配置,优先级又要写进文档并做验证。这部分和规则引擎的优先级配置是同一件事,表达式规范要和优先级规范一起落地,不能只改一头。
实战复盘:一个跑竞价的客户怎么把规则排查时间压下来
背景是一个跑竞价投放的客户,做的是本地服务类落地页,日均点击量在千次出头,跳转插件部署在一台中等规格的服务器上,规则数量当时在四十条上下。他们的规则里大量使用地区、设备、来源渠道三个内置变量做条件分支,早期是运营直接在手写表达式,谁需要谁加一条。
踩的坑集中在三处。一是渠道变量是多值,运营按单值写了等值比较,导致两条渠道规则从来没命中过,流量全落到兜底分支,转化归因一直对不上。二是频次变量在缺值时被当成0,一条“频次小于3走新客页”的规则把所有缺值流量都吸了进去,老客被当成新客展示。三是几条规则的“与”“或”混写没有加括号,实际判定顺序和运营理解的相反,一个本应严格限定的分支被放宽了。
调整过程分三步。第一步先把三个内置变量的取值形态、大小写约定、缺值形态整理成一页变量说明,写清每个变量是单值还是多值、缺值时返回什么。第二步按这份说明重写表达式:多值变量改用包含判断,频次判断前先判空,多条件表达式全部加括号分组,嵌套超过两层的拆成独立规则。第三步加了一套验证顺序:规则上线前用抽样请求逐条回放,确认每条规则在预期输入下命中、在边界输入下不误命中;上线后盯规则命中分布,某条规则命中率突然归零或某条兜底规则命中率异常升高,就回头查表达式。
调整后的状态是规则数量从四十条压到二十多条,排查一条规则的平均时间从原来的大半天降到一两个小时,渠道归因对不上的问题基本消失。没有做什么复杂改造,就是把变量语义和表达式书写规范固定下来,再配一套回放验证。
验证顺序:表达式写完先跑这四步
表达式写完不等于能用,按下面的顺序验证,能把大部分问题挡在上线前。
- 变量语义核对:逐条确认表达式里用到的每个内置变量,取值是单值还是多值、大小写约定、缺值形态,与变量说明一致。
- 边界输入回放: 对每条规则准备三组输入——典型命中输入、典型不命中输入、边界输入(缺值、多值、大小写不一致),逐组回放看判定结果是否符合预期。
- 优先级与互斥检查: 平铺出来的规则之间确认条件是否重叠,重叠部分的命中顺序是否与优先级配置一致,兜底规则是否真的能兜住。
- 上线后命中分布观测: 规则生效后盯每条规则的命中量,命中量突降、突升或兜底规则占比异常,都是表达式可能有问题的信号。
这四步里,第二步最容易被跳过,也最能暴露问题。很多表达式在典型输入下表现正常,一到缺值和多值输入就偏,而线上流量里缺值和多值恰恰不少。
把规范写进规则文档,而不是留在个人记忆里
条件分支表达式的书写规范,最终要落到规则文档里才有约束力。文档至少包含:内置变量清单及取值语义、类型与空值处理约定、运算符优先级与括号使用要求、嵌套深度上限、规则拆分与优先级约定、验证顺序与回放样本要求。新加规则的人按文档写,排查的人按文档对,规则库才不会越写越乱。
规则文档还要和版本管理挂钩。每条规则的表达式变更记录变更人、变更原因和回放验证结果,出问题时能回溯到是哪次变更引入的偏差。这部分和跳转插件的配置版本化管理是同一套流程,表达式规范是内容,版本管理是载体,两者缺一不可。
检查项收束
- 每个内置变量的取值形态、大小写约定、缺值形态是否已书面确认。
- 多值变量是否使用包含判断而非等值判断,匹配方式是否确认。
- 可能为空的变量是否做了前置判空,空值是否会被误判进业务分支。
- 多条件表达式是否用括号显式分组,是否不依赖记忆中的优先级。
- 短路求值顺序是否把易缺值、易异常的判断放在前面并显式处理。
- 嵌套深度是否控制在两层以内,超出的部分是否拆成独立规则。
- 平铺规则之间的条件重叠与命中顺序是否与优先级配置一致。
- 上线前是否完成典型、不命中、边界三组输入的回放验证。
- 上线后是否观测规则命中分布,兜底规则占比是否在合理范围。
- 表达式变更是否记录变更原因与回放结果,能否回溯。