发生了什么
平台给商户一类「免时长」额度:在约定的期限内,用户使用平台的服务不收费,这段可以免费使用的时间按天记账。额度按批次分配给商户,商户名下有一张「扣减卡」,记着这一批分到的天数合计;用户每用掉一天,系统就要把用量记到这张卡上,这一步叫扣减。商户的账和用户的实际使用,靠这张卡上的累计用量对齐。
押金是另一条业务:用户用车前先交一笔保证金,支付成功后会触发回调处理,回调里还会做与商户额度有关的后续处理。这段处理会调用商户额度服务里一个统计扣减卡用量的接口,把这次要记的额度扣减交给它。
正常一次调用这样走完:押金支付成功,回调处理程序带着商户、天数等信息调用统计接口;接口找到这名商户的扣减卡,把本次用量加上并保存;这次扣减当天生效,商户账上就能看到。
这次平台在做额度分配与扣减方式切换,这个统计接口也跟着改了。改动只按一种入参形态写,押金回调这条老调用方传的参数是另一种形态,新代码里没有对应的分支。上线后,押金回调每调用一次就在接口里抛空指针,扣减没有写进库。开发是在发布后看日志时发现的,修改兼容逻辑后又做了一次发布。
确认的影响是累计 114 天的商户额度扣减。发现当天,开发按错误日志里的调用链标识找到每次失败的入参,用同样的入参重新调用接口,把漏掉的扣减补了回来。
本质
一句话:一个被多条调用链共用的接口改了实现,只按其中一种入参形态写了分支;押金回调仍按旧形态传参,接口里没有默认分支,取值时拿到空对象后直接使用,扣减在写库之前就异常退出了。
- 原来的流程。统计接口按请求里的商户和天数找到扣减卡,加上用量再保存。押金回调是改造前就存在的调用方,一直按这套参数调用,接口也一直按这套参数处理。
- 这次改了什么。额度分配与扣减方式切换后,接口内部的统计方式变了,改后的代码只覆盖新方式下的一种入参形态,默认调用方都会按新形态传参,没有为老调用方留默认分支。
- 错在哪一步。押金回调没有跟着改,仍按老形态传参。接口从请求里取不到新形态需要的那部分数据,代码没有兜底,取值步骤拿到空值后直接使用,抛出空指针。
- 为什么测试环境没发现。测试环境和预发环境都没有触发过押金支付成功后的这段处理,需求文档和测试用例里也没有这个场景。新代码在测试里只被按新形态传参的调用方走过,「老调用方不传新参数」这条路径一次都没走到。
- 为什么影响会累积。空指针发生在写库之前,这次调用没有留下扣减记录;失败后没有自动补做,只能事后按日志里的入参重放。调用一天天发生,漏掉的扣减就一天天累积,直到有人看日志发现异常。
共用接口只按一种入参形态写分支,老调用方就会在参数对不上时整条处理失败;失败又发生在写库之前,业务上看到的就是一笔扣减凭空消失。
记录给出的处理是修改兼容逻辑并发布上线,随后按日志重放补齐数据;发布后的验证结果、漏掉的扣减是否已全部对平,记录里没有说明。修复方向是:接口对改造前就存在的调用方保留默认处理,缺参数时按老逻辑走;定位不到扣减卡时明确报错并带上业务单号,不要留下一次静默的空返回。
错误代码
public class MerchantQuotaStatService {
/** 改造后的入口:统计商户扣减卡本次的额度用量 */
public void recordDeductionUsage(DeductRequest request) {
DeductionCard card = null;
if (DeductSource.DAILY == request.getSource()) {
card = quotaRepository.findDailyCard(request.getMerchantId());
} else if (DeductSource.SWITCH == request.getSource()) {
card = quotaRepository.findSwitchCard(request.getMerchantId());
}
// 为什么错:押金回调没有“扣减来源”这个参数,取出来是空,
// 两个分支都不命中,card 保持 null
card.addUsedDays(request.getDays());
// 为什么错:异常在这一行之前就抛出,扣减没有落库,
// 调用方也拿不到可重放的业务结果
quotaRepository.updateUsedDays(card);
}
}
修复代码示例
public class MerchantQuotaStatService {
/** 修复:缺省来源按改造前的处理方式走,兼容押金回调这条老调用方 */
public void recordDeductionUsage(DeductRequest request) {
DeductSource source = request.getSource() == null
? DeductSource.DAILY : request.getSource();
DeductionCard card = switch (source) {
case DAILY -> quotaRepository.findDailyCard(request.getMerchantId());
case SWITCH -> quotaRepository.findSwitchCard(request.getMerchantId());
};
if (card == null) {
// 修复:找不到卡时明确失败并带上业务单号,
// 让调用方和日志都能定位这次扣减,不再静默丢失
throw new QuotaCardNotFoundException(request.getBizNo(), source);
}
card.addUsedDays(request.getDays());
quotaRepository.updateUsedDays(card);
}
}
两段代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现;记录没有写明具体是哪个参数、什么形态,示例以「扣减来源」示意这类新增参数。
下次遇到这些场景要警惕
- 改一个被多条调用链调用的接口前:把所有调用方列出来,逐个核对入参——哪些字段必传、空值代表什么、枚举有哪些取值,再确认每条调用链在测试环境都能被触发。只按自己熟悉的那个调用方改,另一条调用链就会在参数对不上时整条失败。
- 给请求新增参数或枚举值时:用老调用方的请求跑一遍,构造「不传这个字段」「传空值」「传不认识的取值」三种输入,观察是否落到兜底分支、有没有抛空指针;不要只在测试用例里补齐新参数。
- 接口里有扣减、记账这类写操作时:检查异常位置,确认失败时业务上留下可追溯的单号或入参日志。只打印一条异常栈,事后很难还原每一次失败请求,也没法逐笔补数。
- 按日志重放补数据前:先确认接口对同一笔业务可重复执行,避免补一遍变成扣两次;补完后按商户和日期抽几笔核对累计用量,确认和用户实际消耗对得上。