发生了什么
换电业务里,电池放在电柜的格口里。用户来换电,取走一颗满电的电池、放回一颗没电的;电柜装满了就收不进电池,系统因此给一线运维生成“电柜满仓”工单,要求把多余的电池调出去。工单按类型区分,同一类业务还可能并存新旧两版,这次出问题的类型叫“电柜满仓(旧)”。
运维日常在任务看板上看这些工单:看板按指标分组,每个指标下面是某一类工单的入口,点进去是工单列表,再点某一张单,打开工单详情。详情页要显示这张单对应的电柜、电池、数量和现场处理记录,运维照着页面上的信息干活。
工单详情目前是用低代码模板搭起来的:页面结构由配置好的模板决定,换版式不用重写前端代码。这次项目要把一部分工单的详情页换成原生 H5 页面,做法是在“从列表点进详情”这一步加实验分流,按工单类型判断该走新页面,还是继续走原来的低代码模板。电柜满仓(旧)快要下线,产品准备全量替换,所以本次改造不覆盖它,它应当继续留在低代码详情页。
前端在 10 月 16 日晚上发布。发布后加白名单验收,用白名单账号点开任务看板上“不可用”指标里“电柜满仓(旧)”这一类,进入工单详情,页面没有显示数据。这次是灰度部署,实验组流量为 0,只有白名单账号会走到这条判断,线上用户没有受到影响。
问题也没有在 pre 环境被拦住:工单详情用的是低代码模板,这套模板的配置只能从测试环境同步到生产环境,中间没有 pre 这一段,pre 里看不到它。
本质
一句话:跳转时拿数字 3008 去比对工单类型,接口返回的却是字符串 “3008”,条件永远不成立,本该留在旧详情页的类型被送进了新详情页。
-
原流程。详情页只有一套低代码模板,点进任何一张单,页面按工单编号取数展示,不存在按类型选页面这回事。
-
这次改造。新详情页只覆盖改造范围内的类型;电柜满仓(旧)不在名单里,仍应走低代码模板。列表点进详情时增加了实验,靠工单类型这个字段决定走哪一套。
-
写判断时参考了同一个文件里另一个方法的写法:那边的 taskTypeList 是数字集合,比较用的是数字 3008。这里没有核对该接口实际返回的类型,直接沿用了数字。
-
列表接口返回的 taskType 是字符串。数字与字符串比较不相等,这个判断对这类工单永远不成立。
-
电柜满仓(旧)因此没有落回旧详情页,被当成本次改造覆盖的类型跳进了新详情页。新详情页是按本次改造覆盖的类型做的,电柜满仓(旧)不在其中,页面上就没有数据可看。类型对不上时页面不会报错,只会安静地走错分支,最后看起来只是“没有数据”。
-
问题到白名单验收才暴露:灰度实验组流量为 0,线上没人走到;pre 环境没有这套低代码模板的配置,pre 通过不等于这条路径被验证过。
修复是把判断用的类型改成字符串,与接口返回保持一致。记录里没有写修复后的验证情况。
错误代码
// 列表点进工单详情:按工单类型选详情页(脱敏教学示例)
const LEGACY_TYPES = [3008]; // 为什么错:照抄同文件另一个方法的数字集合,没核对本接口返回
function detailUrl(order) {
const taskType = order.taskType; // 接口实际返回字符串 "3008"
// 为什么错:includes 不做类型转换,字符串永远匹配不上数字 3008
if (LEGACY_TYPES.includes(taskType)) {
return `/workorder/detail/lowcode?id=${order.orderNo}`;
}
return `/workorder/detail/native?id=${order.orderNo}`;
}
修复代码示例
// 判断字段与接口返回统一成字符串再比(脱敏教学示例)
const LEGACY_TYPES = ["3008"]; // 与接口返回的类型一致
const NATIVE_TYPES = ["3010", "3011"]; // 类型码为示意,仅表示新详情页覆盖的集合
function detailUrl(order) {
const taskType = String(order.taskType ?? ""); // 先统一类型,再进分支
if (LEGACY_TYPES.includes(taskType)) {
return `/workorder/detail/lowcode?id=${order.orderNo}`;
}
if (!NATIVE_TYPES.includes(taskType)) {
// 不在新名单里的类型回退旧详情,避免新页面取不到数据
return `/workorder/detail/lowcode?id=${order.orderNo}`;
}
return `/workorder/detail/native?id=${order.orderNo}`;
}
下次遇到这些场景要警惕
- 按接口字段做分支判断时:先用真实返回打一条日志,看清字段是字符串、数字还是数组;再用这类工单的真实数据把两个分支各走一遍,确认都能进去。只造同类型的样例测不出这类问题。
- 从别的方法复制判断条件时:把被复制条件所属的接口和字段一起核对,确认是不是同一个来源;来源不同就统一转换后再比较,不要只改常量值。
- 改造只覆盖部分类型时:在跳转处写兜底,类型不在新名单里就回退旧页面;同时把现存类型列成清单逐个点开验收,尤其别漏掉这次不改造、快要下线的旧类型。
- 发布带灰度且流量为 0 时:白名单验收要把白名单账号分别放进实验组和对照组各点一遍;低代码模板这类配置还要确认它在每个环境是否真的同步,pre 通过不能当作这条路径已验证。