发生了什么
充电站里,用户启动一次充电,系统就生成一条充电订单。订单上记录这次充电的过程和金额,具体怎么收费由“计费规则”决定,规则里写清楚按什么标准算这次充电的使用费。
正常流程有两段计算。充电进行中,充电端口会隔一段时间向服务端上报一次心跳,服务端收到上报后,按订单当前的充电情况更新这笔订单的“当前使用费”;充电结束时再结算一次,算出最终使用费并把订单结束掉。这两次计算读的是同一份计费规则。
这次计费改版给计费规则新增了一个字段 timeFeeList,用来存放本次新增的费用项,上面说的两次计算都要读它。改动上线时出了问题:有的计费规则里这个字段没有值,程序读出来是空,而计费代码没有先判断空值,直接把它当成一个一定存在的列表使用。只要有一条规则没有配这一项,走到这段计算就会抛出空指针异常(程序去取一个不存在的值时抛出的错误)。
这次异常就发生在发布过程中:新版本执行到这段计费逻辑时抛出空指针,异常没有被兜住,本次发布被终止,新版本没有上线。修改后再发布才通过。发布被终止、新版本没有上线是确认的;发布期间线上充电订单有没有受到影响,目前没有依据,不能当作没有发生。
本质
问题不在“新增字段”本身,而在读取这个字段的代码假设了它一定有值。
- 计费规则是一份可配置的数据,新增字段不会自动给已有规则补上值。一条规则没有配置这一项时,读出来就是空值。
- 计费程序把
timeFeeList当成一定非空的列表,直接遍历取用,取到空值时抛出空指针异常。 - 读取这个字段的地方有两处:充电中的心跳上报,和充电结束时的结算。两处写的是同一种思路,都没有判空,所以不管先走到哪一处,只要遇到没有配这个字段的规则,都会失败。
- 发布过程中执行到这段计算,异常没有被捕获处理,向上冒到发布流程,发布被判定失败并终止。
- 修改后重新发布才通过。从原因看,修复方向是:读取这个字段前先判空,空值按“没有新增费用项”处理,兜底结果和原计价逻辑保持一致;两处计算收敛到同一个取数方法,避免只改一处、另一处还漏着;发布前用“规则里没有这个字段”的数据把两条路径都跑一遍。
这类问题的特点是:新配置测起来一切正常,出问题的偏偏是存量数据或没有配这一项的数据;它到发布阶段才暴露,说明此前没有人用这类数据走过一遍,而不是代码本身对空值有约定。
下面两段是脱敏教学示例,用于说明错误与修复思路,不代表实际项目源码或已上线实现。示例把费用项简化成可累加的金额,只为让判空这一步看清楚,具体计价口径不影响这个错误机制。
错误代码
class ChargingFeeCalculator {
// 充电中,心跳上报后更新订单当前使用费
void updateFee(ChargingOrder order, BillingRule rule) {
BigDecimal fee = BigDecimal.ZERO;
// 为什么错:新增字段在存量规则或未配置该项的规则上为空,
// 这里默认列表一定存在,取到 null 后直接遍历
for (TimeFeeItem item : rule.getTimeFeeList()) {
fee = fee.add(item.getAmount());
}
order.setCurrentFee(fee);
}
// 充电结束,结算最终使用费
void settle(ChargingOrder order, BillingRule rule) {
BigDecimal fee = BigDecimal.ZERO;
// 同一份规则,第二处读取同样没有判空,
// 只修一处的话,结算这条路径仍会抛空指针
for (TimeFeeItem item : rule.getTimeFeeList()) {
fee = fee.add(item.getAmount());
}
order.setFinalFee(fee);
order.setStatus("SETTLED");
}
}
修复代码示例
class ChargingFeeCalculator {
void updateFee(ChargingOrder order, BillingRule rule) {
order.setCurrentFee(calcUsageFee(rule));
}
void settle(ChargingOrder order, BillingRule rule) {
order.setFinalFee(calcUsageFee(rule));
order.setStatus("SETTLED");
}
// 两处计算共用一个取数入口,空值只在这里处理一次
private BigDecimal calcUsageFee(BillingRule rule) {
List<TimeFeeItem> items = rule.getTimeFeeList();
if (items == null || items.isEmpty()) {
// 没有配置新增费用项时按没有这部分费用处理,
// 兜底金额要与原计价逻辑对齐,不能当成免费
return BigDecimal.ZERO;
}
BigDecimal fee = BigDecimal.ZERO;
for (TimeFeeItem item : items) {
// 明细项为空也跳过,不让整单计算失败
if (item != null && item.getAmount() != null) {
fee = fee.add(item.getAmount());
}
}
return fee;
}
}
下次遇到这些场景要警惕
- 给计费规则、费率表这类配置加字段:先把所有读这个字段的代码入口列出来(这次是心跳更新和结算两处),再用“字段没有值”的规则数据把每个入口各跑一遍,确认不抛异常、兜底金额符合预期,而不是只测新配置。
- 同一个字段被多处读取时:把取值和判空收敛到一个方法里。只改报错的那一处,另一条路径会在别的时机以同样的方式失败。
- 发布流程里出现业务代码异常:先确认异常来自哪条业务路径、用的是什么数据,不要先归因到环境或发布工具;像这次这样在发布阶段就抛出来,说明存量数据没有被覆盖到。
- 新增可选配置项:明确写出“没有配这一项时按什么算”,并在需求评审时就定下来;空值兜底写成 0、跳过还是回退到旧算法,属于业务口径,不能留给实现时临时决定。