发生了什么

自助充电站里,用户扫码付款后,系统按站点配好的“计费规则”生成一条充电订单,再把订单下发给充电设备。计费规则是商户提前配置的收费标准,可以按用电量计费,也可以按时间计费;选了按时间计费,规则里要同时写清每小时的服务费和这次允许充电的小时数,时长这一项的单位是小时。

正常流程是:配置人员把规则存好;用户付款、设备开始供电,规则写了几小时就供几小时;充满、到点或用户手动结束,设备断电、订单结束并结算。设备就是按这个时长判断什么时候断电。

这次线上反馈了一笔订单:付完钱开始充电,第 6 分钟设备就自动断电,订单随即结束,这笔钱被退回。查下来不是设备故障,是规则数据错了:一条按时间计费的服务费规则,时长字段里存的不是小时数,而是设备的功率值。排查共有两条规则这样,其中一条没有被订单用上,真正影响到的是被用上的那一条,涉及一笔订单、一位用户。

临时处理是让配置人员把这两条规则原样打开、再点一次保存,一个字不改,规则就恢复。根治要改代码,记录里提到安排了紧急上线;是否已经上线、是否验证过,记录里没有确认,修复上线状态待确认。

本质

一句话:按时间计费要的是小时数,写进去的却是功率,两个量纲不同的数字共用同一个时长字段,算出来的可用时长就不再是配置的那个时长。

  1. 错在保存这一步。后台的规则表单里同时有功率和时长两类参数,组装保存请求时,按时间计费的时长字段没有从时长输入项取值,拿的是功率值。功率和小时不是一种量,存进规则之后,谁也没法把它当小时用。
  2. 保存前后都没有把关。时长是否为正、是否落在合理区间、和所选的计费方式是否匹配,都没有校验,这条规则就“合法”地生效了,从填表到落库没有一步拦它。
  3. 用户下单时,系统读这条规则,用时长字段算出这次允许充多久。功率值算出来的时长远小于配置时长,设备在充电 6 分钟时到达规则给的上限,自动断电。
  4. 订单提前结束,已支付的钱退回用户。线上看到的是付了钱、充几分钟就断电退款;后台看规则是配好的,只有那个字段的值不是时长。
  5. 后台原样保存就能恢复,说明坏在已存下来的规则数据,不是每次计算的偶发错误。代码修好只挡新写入,存量规则还带着那个数,需要单独重算或重存。
  6. 整个过程没有一处核对:写入时不校验量纲,下发和执行时也没有环节比对“规则写了几小时”和“实际能充几小时”,直到有订单用上它、线上反馈回来才发现。

修复方向是三条:保存和下发时按计费方式取对应参数,明确单位并校验取值范围;生效前算一次可用时长,和后台填写的值比对,不一致就不让生效;对“实际充电时长远小于规则时长”的订单加监控,既能兜住存量规则,也能让下一次先由系统发现。记录里提到的紧急上线针对的是写入代码,是否也覆盖存量规则的重算,记录中没有说明。

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

错误代码

// 教学示例:保存充电计费规则
public void saveRule(BillingRuleForm form) {
    BillingRule rule = new BillingRule();
    rule.setMerchantId(form.getMerchantId());
    rule.setFeeMode(form.getFeeMode());   // 1=按用电量,2=按时间
    rule.setPower(form.getPower());       // 设备功率,按用电量计费时才用

    if (form.getFeeMode() == FeeMode.BY_TIME) {
        // 为什么错:按时间计费要的是小时数,这里却把功率写进时长字段,
        // 两个量纲不同的数字共用一个字段,规则一存就是错的
        rule.setDurationHours(form.getPower());
        rule.setHourPrice(form.getHourPrice());
    }
    // 为什么错:保存前不校验时长是否为正、是否落在合理区间,
    // 错误单位就这样变成一条生效规则,直到真有订单用上它
    ruleMapper.insert(rule);
}

修复代码示例

// 修复示例:按计费方式取参数,并校验单位与范围
public void saveRule(BillingRuleForm form) {
    BillingRule rule = new BillingRule();
    rule.setMerchantId(form.getMerchantId());
    rule.setFeeMode(form.getFeeMode());
    rule.setPower(form.getPower());

    if (form.getFeeMode() == FeeMode.BY_TIME) {
        // 修复点:时长只从时长输入项取,功率不参与这一项
        BigDecimal hours = form.getDurationHours();
        if (hours == null || hours.compareTo(BigDecimal.ZERO) <= 0
                || hours.compareTo(MAX_HOURS) > 0) {
            throw new IllegalArgumentException("按时间计费请填写合理的服务时长(小时)");
        }
        rule.setDurationHours(hours);
        rule.setHourPrice(form.getHourPrice());
    }
    ruleMapper.insert(rule);

    // 修复点:生效前按新规则算一遍可用时长,和填写的值比对
    chargeRuleChecker.assertDurationConsistent(rule);
    // 修复点:存量规则用同一套校验扫一遍,不一致的重算或重新保存
    chargeRuleService.recheckStoredRules(rule.getMerchantId());
}

下次遇到这些场景要警惕

  1. 给计费规则这类配置加“按方式区分参数”的编辑页时,先写清每种计费方式用到哪些字段、单位是什么,保存时按方式取数并校验取值范围;再用单位错误的数值(比如把功率填进时长)提交一次,看是否被拦住。
  2. 规则生效后加一次自检:下单时算出的可用时长,与后台配置的时长、设备上电后实际能充的时长各比一次,不一致就报错或拦住生效,别让它先作用到用户身上。
  3. 改完写入代码别急着收工:把存量规则按“时长是否等于功率、是否超出合理区间”筛一遍,重算或重存,再抽几笔订单核对断电时刻;只改代码,老规则还会继续按错的参数执行。
  4. 回归时造一条“按时间计费、只改时长”的规则,走完整流程:下单、充电到自动断电、退款,观察断电时刻是否与配置时长一致;一条用例可同时覆盖写入、下发和执行三段。