发生了什么
自助充电站里,用户扫码付款后,系统按站点配好的“计费规则”生成一条充电订单,再把订单下发给充电设备。计费规则是商户提前配置的收费标准,可以按用电量计费,也可以按时间计费;选了按时间计费,规则里要同时写清每小时的服务费和这次允许充电的小时数,时长这一项的单位是小时。
正常流程是:配置人员把规则存好;用户付款、设备开始供电,规则写了几小时就供几小时;充满、到点或用户手动结束,设备断电、订单结束并结算。设备就是按这个时长判断什么时候断电。
这次线上反馈了一笔订单:付完钱开始充电,第 6 分钟设备就自动断电,订单随即结束,这笔钱被退回。查下来不是设备故障,是规则数据错了:一条按时间计费的服务费规则,时长字段里存的不是小时数,而是设备的功率值。排查共有两条规则这样,其中一条没有被订单用上,真正影响到的是被用上的那一条,涉及一笔订单、一位用户。
临时处理是让配置人员把这两条规则原样打开、再点一次保存,一个字不改,规则就恢复。根治要改代码,记录里提到安排了紧急上线;是否已经上线、是否验证过,记录里没有确认,修复上线状态待确认。
本质
一句话:按时间计费要的是小时数,写进去的却是功率,两个量纲不同的数字共用同一个时长字段,算出来的可用时长就不再是配置的那个时长。
- 错在保存这一步。后台的规则表单里同时有功率和时长两类参数,组装保存请求时,按时间计费的时长字段没有从时长输入项取值,拿的是功率值。功率和小时不是一种量,存进规则之后,谁也没法把它当小时用。
- 保存前后都没有把关。时长是否为正、是否落在合理区间、和所选的计费方式是否匹配,都没有校验,这条规则就“合法”地生效了,从填表到落库没有一步拦它。
- 用户下单时,系统读这条规则,用时长字段算出这次允许充多久。功率值算出来的时长远小于配置时长,设备在充电 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());
}
下次遇到这些场景要警惕
- 给计费规则这类配置加“按方式区分参数”的编辑页时,先写清每种计费方式用到哪些字段、单位是什么,保存时按方式取数并校验取值范围;再用单位错误的数值(比如把功率填进时长)提交一次,看是否被拦住。
- 规则生效后加一次自检:下单时算出的可用时长,与后台配置的时长、设备上电后实际能充的时长各比一次,不一致就报错或拦住生效,别让它先作用到用户身上。
- 改完写入代码别急着收工:把存量规则按“时长是否等于功率、是否超出合理区间”筛一遍,重算或重存,再抽几笔订单核对断电时刻;只改代码,老规则还会继续按错的参数执行。
- 回归时造一条“按时间计费、只改时长”的规则,走完整流程:下单、充电到自动断电、退款,观察断电时刻是否与配置时长一致;一条用例可同时覆盖写入、下发和执行三段。