发生了什么
平台会给商户发一种“免时长”额度:在约定期限内,用户使用服务不收费,这段免费时间按天记账。额度开通时,系统写一条套餐时长记录,记下这次开通的是哪种套餐、一共多少天、从什么时候开始生效。此后由后台定时任务每天扫描仍然有效的套餐,往每日扣减记录里写一条“今天扣了一天”。商户可以把额度分给名下用户,用户每用一天就消耗一天。
退回时要按实际用掉的天数结算。用户开通后不满 24 小时就退回,实际只用了不到一天,按约定只该扣一天,多扣的天数要退回。退还流程的做法是:先拿这次开通的套餐标识去查每日扣减记录,看这几天到底扣了几天,再把差额补回去。
这次商户反馈的正是这个场景:一张免时长卡开通不到一天就用不下去了,系统扣了 2 天,多扣的那天没有退回。查下来,扣减记录里存的套餐标识和退还流程查的标识不是同一套。扣减记录存的是套餐配置号,也就是“这种套餐一共多少天”的模板编号,同一种套餐的所有开通记录共用这个号;退还流程按这次开通的套餐实例号去查。两边对不上,一条明细也查不到,退还这一步就被跳过了。
这套扣减记录的写入方式,是 2025 年下半年的用户服务迁移技改中改成现在这样的,当时取了错误的编号,此后一直沿用。
本质
- 开通时,套餐时长记录里写的是一个套餐实例标识,每次开通各不相同。
- 每日扣减任务扫描有效套餐,把查询结果里的套餐标识写进扣减记录。这条查询的结果映射把“套餐配置号”这一列映射到了套餐标识属性上,于是写进扣减记录的是配置号,不是这次开通的实例号。
- 退还流程按套餐时长记录里的实例号加开通时间去查扣减记录,分配扣减模式下这段查询只能是空结果——写进去的和查出来的不是同一套编号。
- 查不到明细时,这段逻辑判定“这次开通没有产生每日扣减”,退还分支到此结束,已经扣掉的天数不再调整。页面和账单上看到的就是扣了 2 天、应退的一天没有退。
同一条记录里,写入端用模板号、读取端用实例号,退还逻辑永远看不到自己写下的扣减明细。
修复方向是把扣减记录的套餐标识改成与开通激活同一个来源,取这次开通的订单号。记录中已完成该处修改,是否全量生效以发布记录为准。
错误代码
// 每日扣减任务:扫描仍有效的额度,逐天写扣减记录
public void scanUserOnly() {
for (FreeTimeCard card : cardMapper.scanValidCards()) {
deductionMapper.insert(new DeductionRecord(
// 错:这条查询的结果映射把“套餐配置号”塞进了套餐标识属性
// 写进扣减记录的是模板号,同一种套餐的所有开通共用它
card.getPackageId(),
card.getDeductDate(),
card.getAmount()));
}
}
// 退还流程:查这几天的扣减明细,决定退几天
public RecoveryResult checkInadequate24HourRecovery(DurationRecord duration) {
// 这里查的是本次开通的套餐实例号,和上面写进去的配置号对不上
List<DeductionRecord> records = deductionMapper.queryByPackageIdAndCreTime(
duration.getPackageId(), duration.getActivateTime());
if (records.isEmpty()) {
// 错:查不到就当成“没有产生每日扣减”,整个退还分支被跳过
return RecoveryResult.none();
}
return RecoveryResult.partial(records.size(), duration.getTotalDays());
}
修复代码示例
public void scanUserOnly() {
for (FreeTimeCard card : cardMapper.scanValidCards()) {
// 对:套餐标识统一取开通激活时写入的那个实例号(订单号)
// 同一种套餐的不同开通各有各的号,不会再共用模板号
deductionMapper.insert(new DeductionRecord(
card.getOrderId(),
card.getDeductDate(),
card.getAmount()));
}
}
public RecoveryResult checkInadequate24HourRecovery(DurationRecord duration) {
// 查询条件不变,仍按这次开通的套餐实例号匹配
List<DeductionRecord> records = deductionMapper.queryByPackageIdAndCreTime(
duration.getPackageId(), duration.getActivateTime());
if (records.isEmpty()) {
// 标识对齐后仍旧为空,才说明这次开通确实没有产生扣减
return RecoveryResult.none();
}
return RecoveryResult.partial(records.size(), duration.getTotalDays());
}
FreeTimeCard 是扫描出来的有效套餐,getOrderId() 是开通时的套餐实例号;DurationRecord 是套餐时长记录,getPackageId() 存的是同一个实例号;RecoveryResult 表示实际扣减天数与应补天数。示例是脱敏教学代码,只保留与标识混用有关的部分,结果映射的具体列配置和退还天数计算仍需按实际实现核对。
下次遇到这些场景要警惕
- 迁移或新增一个按天扣减的后台任务:核对它写入的关联标识与开通、查询两端是否同一个来源;同名字段在不同表里含义不一致时,先查清是哪一类编号再落库。
- 结果映射里出现多个相似列名:如配置号、套餐号、订单号并存,逐个确认每个属性取到的是哪一列,并用一条真实数据打印出写入值,而不是只看字段名。
- 业务分支以“查不到明细”作为跳过条件:检查这个“查不到”是业务上真的没有,还是标识、时间条件写错;退还、补偿这类会产生用户可见结果的分支要留下可核对的查询日志。
- 写入与读取在同一条链路上:拿一笔真实单据做端到端核对,写一条扣减记录后立刻按退还流程的查询条件查一次,确认能查回来。