发生了什么
平台会给商户一类“免时长”额度:在约定期限内,用户使用某项服务不收费,这段可以免费使用的时间按天记账。额度不是整块发下去的,商户每采购一批,系统里就留一条批次券,记着这批天数属于哪个商户、哪个城市、哪个套餐类目、配多少块电池,还剩多少天没有分配。商户在后台把天数分配给名下用户,分出去多少,就从名下额度里扣掉多少。
按什么方式扣,由扣减模式决定。这批商户用的是分配扣减模式:给用户分配天数时,系统直接从商户的额度里扣,所以分配前必须先算一遍这个商户还剩多少天,够才继续,不够就提示“批次可扣减天数不足”,分配不落库。
正常算法是:拿商户、城市、套餐类目、电池数这四个条件,把这个商户名下所有符合条件的批次券找出来,把剩余天数加起来,用这个合计数做校验。
这次不一样。商户在后台给用户修改免时长天数,页面提示“批次可扣减天数不足”,操作失败;而在业务台账上,这个商户的免时长剩余天数明显还有富余。记录没有写受影响的商户数、持续多久,只确认了在分配扣减模式下,会出现商户有余额却分配不了的结果。
本质
问题出在校验前查余额的条件上:代码把免时长套餐配置编号当成了这笔余额的归属键。
- 余额应当按业务维度汇总。一个商户的同类免时长可以来自多条批次券,只要商户、城市、套餐类目、电池数相同,它们就属于同一笔余额,少算任何一条,合计数都会变小。
- 代码用的却是免时长套餐配置编号。这个编号标识的是一份套餐配置,不是一批额度;正常情况下,一份配置一个编号,看起来足以区分商户名下的同类套餐。
- 可这个编号并不唯一。此前新增套餐配置时出现过并发写入,同一份配置在库里留下了多条记录,各自生成一个编号。于是同一商户、同一类免时长的批次券,被分挂在几个不同编号下。
- 余额查询只按其中一个编号过滤,只会带出挂在这个编号下的批次券。其他编号下的批次券不参与汇总,算出来的余额比实际少。
- 校验拿这个偏小的余额和要分配的天数比,判成天数不足,分配被拒绝。业务看到的提示是“批次可扣减天数不足”,真正的原因却是余额没有查全,而不是真的不够。
一个“一般情况下唯一”的内部编号,在历史并发写入的数据里并不唯一;按它算余额,只算到了其中一部分批次券。
记录里给了两层处理。临时做法是订正数据,把同一份套餐配置下各条批次券的编号统一成同一个,让余额查得全,业务先恢复。长期做法是改掉查询条件,按商户、城市、套餐类目、电池数四个维度汇总,记录写明这次改动在 1 月 29 日上线。上线后有没有逐笔核对“校验用余额”与批次券合计一致,记录里没有说明。代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。
错误代码
public interface FreeDurationBatchMapper {
// 为什么错:余额只按“套餐配置编号”汇总,而同一份配置在历史并发写入后
// 存在多个编号,挂在其编号下的批次券都被排除在外
@Select("SELECT SUM(remain_days) FROM free_duration_batch WHERE config_id = #{configId}")
Integer sumRemainByConfigId(@Param("configId") Long configId);
}
public class FreeDurationAllocService {
/** 分配扣减模式:给用户分配天数前,先查商户剩余额度做校验 */
public void allocate(Long configId, Long userId, int days) {
Integer remain = batchMapper.sumRemainByConfigId(configId);
if (remain == null || remain < days) {
// 为什么错:拿到的是部分批次券的合计,却当成商户全部余额,直接判成不足
throw new BizException("批次可扣减天数不足");
}
batchMapper.deductByConfigId(configId, days);
userQuotaMapper.addDays(userId, days);
}
}
修复代码示例
public interface FreeDurationBatchMapper {
// 按商户、城市、套餐类目、电池数汇总,商户同类免时长的全部批次券都参与
@Select("SELECT SUM(remain_days) FROM free_duration_batch " +
"WHERE merchant_id = #{merchantId} AND city_id = #{cityId} " +
" AND category_id = #{categoryId} AND battery_count = #{batteryCount}")
Integer sumRemain(@Param("merchantId") Long merchantId,
@Param("cityId") Long cityId,
@Param("categoryId") Long categoryId,
@Param("batteryCount") int batteryCount);
}
public class FreeDurationAllocService {
/** 校验和扣减用同一组业务维度,两边算的必须是同一笔余额 */
public void allocate(AllocCommand cmd) {
int remain = batchMapper.sumRemain(cmd.getMerchantId(), cmd.getCityId(),
cmd.getCategoryId(), cmd.getBatteryCount());
if (remain < cmd.getDays()) {
throw new BizException("批次可扣减天数不足");
}
// 扣减沿用同一组条件,不再依赖某一个配置编号
batchMapper.deductByScope(cmd);
userQuotaMapper.addDays(cmd.getUserId(), cmd.getDays());
}
}
下次遇到这些场景要警惕
- 给“余额够不够”这类校验写查询时:先列出这笔余额由哪几个业务维度决定,再故意用一个维度不全的条件跑一次,把查询结果和各批次券剩余天数的合计摆在一起看,确认会不会少算。
- 准备把某个字段当唯一键用之前:先在这个字段上做一次重复检查,按它分组看有没有计数大于 1 的行,尤其要查历史上出现过并发写入、批量导入或复制配置的表。
- 遇到“余额充足却提示不足”的反馈:不要先怀疑额度被别处占用,先把校验查询返回的余额和台账合计对比,看差多少、差在哪些批次,再决定是改数据还是改查询。
- 统一编号或用改数据止血之后:按同一商户再走一次完整分配,确认校验余额等于全部批次券剩余天数之和,并且分配后两边同步减少,避免只让这一笔通过。