发生了什么
用户在换电业务里买套餐:打开套餐购买页,选好套餐往下翻,页面最下面是固定的支付栏,支付按钮始终贴在屏幕底部。支付栏下面是全局的底部导航栏(Tabbar,几个入口图标横排的那一条),导航栏再往下是手机的安全区——全面屏 iPhone 底部那条手势横条所在的位置,系统不允许内容压在它上面,否则按钮点不到。
所以支付栏的位置不是写死的:它距屏幕底部的距离,必须正好等于底部导航栏的高度加上安全区的高度。这个数值有两条来路:普通浏览器里的页面由样式表自己取安全区,代码不用关心数字;跑在客户端容器里的页面取不到这个样式值,只能由脚本向客户端要一个安全区高度,再加上导航栏高度,手动把支付栏抬上去。底部另外两个浮层(搭售悬浮条、优惠明细浮层)用的是同一套算法。
底部导航栏当时有两个版本同时在灰度:旧版高度是 120,新版是 112,按流量比例放量,用户落在哪一版由客户端的灰度开关决定。
这次反馈来自一位 iPhone 用户:页面翻到最后,支付按钮被挡住了,怎么都点不到,付不了款。记录显示只有一部分用户会碰到——旧版首页(只放了很小一部分流量)加容器端的组合,这两个版本都已计划下线。支付栏被压住的同时,同样位置的搭售悬浮条和优惠明细浮层也一起下沉了。
本质
一句话:支付栏的抬高量由两段相加,导航栏高度那一段被写死成新版的值,旧版下少了 8;安全区那一段在容器端旧版里从来没被初始化过,读到的永远是 0。
- 两个版本共用一套算法。导航栏改版时新旧并行灰度,高度差 8 个设计单位(120 与 112)。底部浮层要贴住导航栏上沿,就必须按当前生效的那一版取值。
- 写死的值早就埋下。客户端容器接入时,脚本需要自己拼安全区,写这段代码的人把导航栏高度直接写成了 112。当时只有容器端这一条路、还不区分版本,所以容器端跑旧版时就已经少算了 8。
- 6 月初一次改动放大了它。那次改动要修支付栏被遮挡,把走脚本计算的条件从“只在容器端”扩成“容器端或新版导航栏”,高度值却没跟着按版本取,写死的 112 被用到更多组合上。
- 出错的第一步。脚本没有“按灰度版本取高度”这一步,跑的明明是旧版导航栏,抬高量仍按 112 算,支付栏和两个浮层都下沉 8,正好压到导航栏边上。
- 出错的第二步,这一处更致命。安全区高度不是自动就有的:容器端要显式调一次初始化,客户端才会把真实值填进来,不调则一直是默认的 0。新版导航栏组件挂载时自己初始化了,旧版导航栏组件没有。于是容器端跑旧版时,脚本算出的抬高量连整个安全区都丢了。
- 结果。抬高量少了 8,又少了一整段安全区,支付栏落到导航栏和手势条后面。按钮还看得见一部分,但那片区域已经归导航栏接管,点击落不到按钮上。
- 为什么没被拦住。安全区的初始化职责被拆给各版本导航栏自己管,旧版这条分支漏了,也没有统一入口兜底;而漏掉的这条分支只在“旧版首页灰度 + 容器端 + iPhone”三者同时成立时才出现,日常用浏览器打开、或落到新版导航栏,都看不到。
抬高量同时取决于灰度版本和设备安全区,代码却只写死了一个版本的高度、还指望每个版本自己记得初始化安全区,没走到的分支就必然算错。
修复做了两件事:三处脚本计算都改成按灰度开关取对应的导航栏高度;旧版导航栏补一次安全区初始化,且只在容器端且 iOS 时执行,放在首帧渲染前同步完成,避免先按 0 渲染一帧再跳。第一版对所有容器端都初始化,引入了回归,才收窄到这一类端;设备判断走统一的系统识别方法,没有自己拼 UA。记录里这条问题标为已完成,后续的回归验证范围没有说明。
错误代码
// 底部浮层抬高量计算与导航栏初始化(脱敏教学示例,非项目源码)
class PayBarOffset {
// 为什么错:只有一个常量,取的是新版导航栏的 112,旧版是 120
static final int TABBAR_HEIGHT = 112;
int bottom(boolean newTabbar, boolean container, ContainerEnv env) {
if (container || newTabbar) {
// 为什么错:分支里已经知道版本,取值时却仍用同一个常量
return TABBAR_HEIGHT + env.insetBottom();
}
return 0; // 普通端交给样式表的安全区,这里不参与
}
}
class TabbarV2 {
void mount(ContainerEnv env) { env.init(); } // 新版挂载时自己初始化了
}
class TabbarV1 {
void mount(ContainerEnv env) {
// 为什么错:旧版没有调 init(),env.insetBottom() 一直返回默认 0
}
}
修复代码示例
// 修复:高度按灰度版本取,安全区由旧版导航栏自己初始化一次
class PayBarOffset {
static final int TABBAR_HEIGHT_V2 = 112;
static final int TABBAR_HEIGHT_V1 = 120;
int bottom(boolean newTabbar, boolean container, ContainerEnv env) {
if (container || newTabbar) {
// 修复:按当前灰度实际生效的版本取高度,不再共用一个常量
int height = newTabbar ? TABBAR_HEIGHT_V2 : TABBAR_HEIGHT_V1;
return height + env.insetBottom();
}
return 0;
}
}
class TabbarV1 {
// 修复:容器端且 iOS 时,在首帧渲染前同步初始化,读到的就不是 0
TabbarV1(boolean container, boolean ios, ContainerEnv env) {
if (container && ios) { env.init(); }
}
}
下次遇到这些场景要警惕
- 同一个高度被两个并行灰度的版本共用时:先列出每个版本的实际取值,再搜出所有引用它的地方,逐个确认是“按当前版本取”还是“写死一个常量”。写死的常量被扩大后的条件用到另一版本,误差就跟着放大。
- 把安全区这类环境数值交给各版本组件自己初始化时:画出每个版本从挂载到首帧渲染的顺序,确认每条分支都拿到非零真实值;在旧版分支上把算出的抬高量和手工量的像素对一遍。
- 只在真机、只在某个客户端容器里才复现的遮挡问题:把条件拆成“端类型 × 导航栏版本 × 系统”三列逐格跑,别用浏览器里正常就判定通过;点击是否被截走要单独看,遮挡区域上层元素会先接到事件。
- 修复要限定生效范围时:先小范围放量观察一版,再收窄或放开条件,并留能回退的开关;初始化类改动放在首帧渲染前完成,避免第一帧按默认值画出来再跳。