发生了什么
平台会给商户发一种“免时长”额度:在约定期限内,用户使用这项服务不收费,这段可以免费使用的时间按天记账。额度有一种用法叫“分配扣减”:商户把若干天分给名下用户,用户每过一天就消耗一天。系统为此留一条关联关系记录,写清这次分给了谁、一共多少天、已经用掉多少天。
每天凌晨另有一个定时任务结算,把前一天实际消耗的天数从商户额度里扣掉,同时在关联关系记录里累加已使用天数。用户用完、商户要提前收回,就由商户操作关闭这笔订单,系统按已用天数结算,把没用掉的天数退回商户额度,订单随之结束。
这次的不同在于,商户在用户开启后不到 24 小时就操作关闭。产品规则里有一条补偿:24 小时内关闭要多返一天,理由是开启当天用不满一整天,除了按已用天数结算,还要另外退还一天。
事情是按这个顺序发生的。用户开启时,系统已经把这一天记进关联关系记录,已使用天数为 1。当天夜里过去,凌晨的扣减任务照常运行,它又为同一天记了一次消耗,已使用天数变成 2。商户在这个 24 小时窗口内点关闭,系统拿到的已使用天数是 2,不是规则设想的 1;按 1 天写的返还算法在这里走不下去,返还天数这一步报错退出。
关单是把结算和状态变更放在一次操作里做的,返还失败后整个关闭请求没有完成:订单仍是开启状态,天数也没有退回商户额度。只要这条记录还是已使用 2 天,商户再点一次也是同样的失败。
本质
问题不在某一行的加减,而在于两条各自成立的写入路径,和一条按旧假设写的结算规则,三者合起来出现了一个规则没有描述过的状态。
- 开启这条路径:用户开启当天就记一天,已使用天数从 0 变成 1。这条路径原本也能满足“24 小时内关闭多返一天”的结算,因为当时窗口里最多只有这 1 天。
- 扣减任务这条路径:每天凌晨把前一天消耗记进同一张关联关系记录。它的存在是为了让已使用天数和商户额度的扣减保持同步,本身没有问题。
- 两条路径写的是同一个已使用天数。开启在白天,扣减在次日凌晨,24 小时窗口正好跨过凌晨,于是窗口内这个数已经是 2,而“多返一天”的规则只按 1 天算过。
- 关闭(回收)按已使用天数推算应退天数,再加那额外一天。已使用天数为 2 时,这套按 1 天写出来的算法对不上账,返还在写回时抛错。
- 关单把结算和状态变更放在同一次操作里,返还失败后关闭没有提交,订单保持开启,商户在这段时间里反复操作都停在同一个错误上。
同一个“已使用天数”被开启和凌晨扣减各写一次,24 小时窗口跨过凌晨后,按 1 天写好的“多返一天”结算落在 2 天这个值上,直接报错。
修复方向是回收时先判断这一天是否已被凌晨任务扣减过:扣减过就把已使用天数先减回一天,再按“多返一天”结算,这样窗口内两种写入顺序都能落到规则预期的 1 天上。示例里另外加了回收状态判断,因为减天这一步必须只做一次,商户重复提交时不能重复减。
错误代码
// 用户开启:开启当天先记一天
public void activate(long relationId) {
relationMapper.increaseUsedDays(relationId, 1); // 此时已使用天数为 1
}
// 凌晨扣减任务:把当天消耗记进同一张关联关系记录
public void deductDaily(long relationId) {
Relation relation = relationMapper.get(relationId);
cardMapper.deduct(relation.getCardId(), 1);
relationMapper.increaseUsedDays(relationId, 1); // 同一自然日又被记一次,变成 2
}
// 商户关闭(回收):不足 24 小时要多返一天
public void close(long relationId) {
Relation relation = relationMapper.get(relationId);
int usedDays = relation.getUsedDays(); // 时间窗跨过凌晨时,这里拿到的是 2
int refundDays = usedDays + 1; // 错:多返一天只按“开启后未被扣减”的 1 天写过
// 错:已使用天数已经是 2,这行写回时直接抛错,返还没有完成
relationMapper.decreaseUsedDays(relationId, refundDays);
cardMapper.refund(relation.getCardId(), refundDays);
orderMapper.close(relation.getOrderId()); // 返还失败,关单没有完成
}
修复代码示例
public void close(long relationId) {
Relation relation = relationMapper.get(relationId);
if (relation.isRecycled()) {
return; // 对:回收只走一次,避免重复减天
}
int usedDays = relation.getUsedDays();
// 对:先确认凌晨任务是否已经为这一天扣减过
if (cardMapper.hasDeducted(relation.getCardId(), relation.getActivateDate())) {
relationMapper.decreaseUsedDays(relationId, 1); // 对:把重复记上的那一天减回来
usedDays = usedDays - 1;
}
int refundDays = usedDays + 1; // 多返一天,不再超出可退范围
relationMapper.decreaseUsedDays(relationId, refundDays);
cardMapper.refund(relation.getCardId(), refundDays);
orderMapper.close(relation.getOrderId());
}
Relation 是用户与商户这次分配的关联关系记录,getUsedDays() 是它记的已使用天数;cardMapper 是商户额度那一侧的扣减与退还,hasDeducted 用额度编号和开启日期判断这一天有没有被扣减过。修复的关键是让两种写入顺序在结算前收敛到同一个计数,再执行多返一天。示例为脱敏教学代码,用于解释错误与修复思路,不代表实际项目源码或已上线实现;实际判断条件和回收状态字段需按实现核对。
下次遇到这些场景要警惕
- 给按天记账的额度新增一条会改已使用天数的路径(定时扣减、人工调整、批量导入):先列出所有读这个天数的结算分支,再在“新路径已经执行过”的状态下把每个分支重算一遍,不能只看新路径自己写对了。
- 规则里出现“不足 24 小时”“次日生效”“跨天”这类时间窗:把开启时间放在 23:59、任务执行放在次日 00:01 这种边界上构造数据,确认窗口内是否可能已经多出一次写入。
- 关闭、退还这类同时改状态和额度的操作:故意让结算那一步失败,观察订单状态是否被错误推进、额度是否只改了一半、商户重试能否恢复;不要让失败被吞掉后又把状态改掉。
- 退还天数写回之前:校验应退天数是否落在记录已记天数之内,并想清楚越界时是报错还是按可退上限截断——报错会把整个关单一起拖失败。