发生了什么

换电业务的用户手里有一块可换的电池。用户不想继续用时,可以在 App 里发起“电池回收退回”:把电池交回,系统按这张回收单发起一笔支付结算,页面在这一步把金额和单据信息交给支付层。

正常顺序是:用户点“回收退回”,页面组装支付参数交给支付层,支付层解析后向支付渠道发起请求,成功后回收单继续往下走。页面原先是原生页面,跑在 App 自带的页面容器里,支付参数按“一张单据可能带多条支付项”设计,交给支付层的是一个支付项列表,参数名是 payList。

一次移动端适配改造把换电业务的一部分原生页面改成了 H5 页面,也就是在 App 里套一个网页,支付由 H5 的支付入口完成。新的支付入口换了参数约定:不再接收列表,而是要求调用方直接传 amount(金额)和 order(单据号)。

改造前的影响面评估里,电池回收页面被列为要一起调整的模块。但这次代码改动没有覆盖到这个模块,也没有通知负责换电业务的测试安排回归,这个入口不在日常回归清单里。

2026 年 8 月初,有用户反馈:点“回收退回”没有反应,回收单停在这一步,无法继续。排查确认,回收模块交给支付层的仍然是 payList,而 H5 支付入口按 amount、order 解析,参数在这一步解析失败,支付请求根本没有发出去;用户端也没有看到任何错误提示,看到的就是点了没反应。当时近一周走过这条链路的用户只有 1 个,反馈的正是这一位。

处理分两步:先把灰度分流里这位用户切回原生页面容器,恢复正常操作;再在支付层补上对 payList 的判断,业务逻辑不动,全量发布后把这位用户的分流切回 H5。这次修复是否已经全量发布并验证,记录没有说明。

本质

一句话:一次把页面从原生容器搬到 H5 的改造换了支付参数的结构,但回收模块生成参数的代码没有跟着改;支付层按新结构解析,遇到老结构就失败,回收退回在 H5 上整段走不通。

  1. 老结构按“一张单据可能带多条支付项”设计。回收页把支付项列表 payList 交给支付层,支付层遍历这个列表逐项处理,金额和单据号都藏在列表项里。
  2. H5 改造换了入口约定:调用方不再传列表,而是直接传金额 amount 和单据号 order,由支付入口自己组装请求。
  3. 回收页随着改造被切到 H5,但页面组装支付参数的代码没有动,仍然只产出 payList。
  4. 用户点“回收退回”,H5 页面把 payList 交给新支付入口。新入口按 amount、order 取值,两个键都取不到,参数解析在这一步失败,支付请求没有发出去,页面上没有任何反馈。
  5. 页面没有把解析失败的异常显示出来,用户端只剩“点了没反应”这一种表现;回收单没有产生下一步记录,只能从订单侧反查。

评估表里写了这个模块要改,不等于代码真的改了;支付参数从列表换成单笔,解析端也不会自动兼容老结构。

这类问题和业务规则判断无关,是同一份数据存在两套约定、迁移只改了一边。失败点在参数解析,不在业务判断,表现出来不是金额算错或状态不对,而是入口处整段不可用,连错误提示都没有。

拖了这么久才被发现,有三个原因:一是这个页面是低频入口,近一周只有 1 个用户走过这条链路;二是改造没有通知到换电业务的测试,回归清单里没有这一项;三是灰度分流把用户分到原生容器或 H5 两套页面,只有被分到 H5 的用户才会撞上。

修复方向是让支付层同时认两种结构:收到 payList 就走原来的多支付项分支,收到 amount、order 就走新结构,业务代码不用改。记录给出的修复就是“在支付层面补充 payList 的参数判断,不修改业务逻辑”。

下面两段代码为脱敏教学示例,说明错误与修复思路,不代表实际项目源码或已上线实现,类名与字段名为示意。

错误代码

// 脱敏教学示例:回收页组装参数 + H5 支付入口解析参数
public class RecyclePayBuilder {
    // 回收页仍按老结构组装:一张回收单可能带多条支付项
    public Map<String, Object> build(RecycleOrder order) {
        Map<String, Object> param = new HashMap<>();
        param.put("payList", order.getPayItems());
        return param;
    }
}

public class H5PayParser {
    // H5 支付入口按新约定解析,只认 amount 和 order
    public H5PayParam parse(Map<String, Object> param) {
        H5PayParam pay = new H5PayParam();
        // 为什么错:payList 里没有 amount、order 两个键,
        // 这里取到的都是 null,转成金额时直接抛错
        pay.setAmount(new BigDecimal((String) param.get("amount")));
        pay.setOrderNo((String) param.get("orderNo"));
        return pay;
    }
}

修复代码示例

// 修复:支付层同时识别两种参数结构(脱敏教学示例)
public class H5PayParser {
    public H5PayParam parse(Map<String, Object> param) {
        if (param.get("payList") != null) {
            // 修复:老结构进原来的多支付项分支,
            // 不再被当成新结构按 amount、order 解析
            List<PayItem> items = castPayItems(param.get("payList"));
            return H5PayParam.ofPayList(items);
        }
        // 新结构保持原有处理
        return H5PayParam.ofAmount(
                new BigDecimal((String) param.get("amount")),
                (String) param.get("orderNo"));
    }
}

两段代码改的是同一处:解析入口按参数里实际带的键走对应分支。示例只覆盖兼容读取,没有改动回收单的业务逻辑;解析失败时给出可读提示属于额外建议,不在记录给出的修复内容里。

下次遇到这些场景要警惕

  • 做页面容器迁移时:原生转 H5、换 WebView、换小程序容器,先把这条业务里所有发起支付、调用桥接的地方列出来,再在目标容器里真实走一遍,看到支付界面真的起来、参数真的被识别,不要只确认页面能打开。
  • 影响面评估表上的模块:每一项都要能对应一条代码改动,或者一条明确的“无需改动”结论。上线前按清单逐项核对,评估过但没改的模块最容易漏。
  • 跨业务线的改造:同步到对应业务的测试,尤其是低频入口,日常回归不会经过;给这类入口配一条冒烟用例或入口级监控,统计点击后支付请求的成功数。
  • 收到“点击没反应”的反馈时:先确认前端有没有吞掉异常,再抓一次实际请求参数,和当前容器期望的结构逐字段比对,不要先查业务状态;灰度分流能按用户切回老容器只是止血,记下切回的用户,修复后再迁回。