发生了什么
商家可以在后台给用户发放服务时长,操作上叫“分配”。比如用户原本的时长用完了,商家给他补 30 天。这段时长在系统里落在一条“用户套餐”记录上,记录同时保存两个值:剩余天数(用户还能用多少天)和有效期结束时间(用到哪一天,用户端页面显示成“到期日”)。这两个值由同一个数推出来:到期日等于套餐开始日期加剩余天数,正常情况下必须一致。
分配不是一次写完的。商家提交分配后,系统先把天数加到记录上,再发一条消息给后台程序,由后者完成“激活”,把这段时间真正算成用户可用的时长,并写入到期日。激活是异步的:提交请求先返回成功,后台程序稍后才处理这条消息。
这次商家对同一个用户先后提交了两次分配。第二次提交时,第一次分配触发的激活还没有被执行。用户看到的最终结果是:剩余天数是 30 天,到期日却显示今天,也就是这份刚分配的套餐在页面上当场就过期。用户反馈的现象就是“分配了 30 天,系统显示今天到期”。
本质
时长分配由两个程序分工完成,它们改的是同一条记录上的不同字段,而且都没有先拿到对方的最新结果:
- 累加入口:商家每次提交分配,它按记录编号读出这条用户套餐,把剩余天数加上去,然后只更新剩余天数这一列,不动到期日。
- 激活入口:后台程序消费激活消息,按用户套餐编号找到记录,把消息里带的到期日写进有效期。这个到期日是提交分配那一刻按当时剩余天数算出来的,写进消息后就固定了,之后不会跟着剩余天数再变。
- 第一次分配把剩余天数加上去,同时发出激活消息,消息里的到期日按当时的剩余天数算出,是一个偏早的日期。
- 第二次分配又只把剩余天数累加了一遍,既没有重算到期日,也没有让前一条激活消息失效。
- 后台激活程序这时才执行,把消息里那个偏早的到期日写进有效期,于是剩余天数是新的、到期日是旧的。
剩余天数和到期日必须来自同一次读取;只要它们分别被不同入口按各自的旧值写入,页面上就一定会出现“天数还在、日期已过”。
修复方向是用一把分布式锁把两个入口串起来,锁的 key 统一用这条用户套餐记录的编号。累加入口本来就有记录编号,直接加锁;激活入口只有用户套餐编号,先查出记录编号,再按同一把锁加锁。锁内必须重新读一次最新记录,并用锁内最新的剩余天数重算到期日,丢弃消息里带来的日期。拿不到锁时,激活抛异常交给消息重试,累加直接返回失败让前端重试;新建套餐的写入路径也要纳入同一把锁,否则仍有一条旁路在写到期日。修复已按这个方式在后续迭代完成,上线后的验证情况待确认。
错误代码
// 累加入口:只改剩余天数,到期日留给另一个程序写
public void addSurplusDays(long recordId, int days) {
UserPackage p = packageRepo.findById(recordId);
p.setSurplusDays(p.getSurplusDays() + days);
packageRepo.updateSurplusDays(p); // 为什么错:只写剩余天数,到期日仍停在旧值
}
// 激活入口:直接采用消息里带来的到期日
public void activate(long userPkgId, Date endTimeFromRequest) {
UserPackage p = packageRepo.findByUserPkgId(userPkgId);
p.setPeriodValidity(endTimeFromRequest); // 为什么错:这是按旧剩余天数算好的日期
packageRepo.updateValidity(p); // 为什么错:写之前没有重查最新剩余天数
}
// 发起分配时,把当时算出的到期日一起塞进激活消息
mq.send(new ActivateMsg(userPkgId, DateUtils.addDate(startTime, currentSurplusDays)));
修复代码示例
// 两个入口统一按记录编号加锁,锁内重读、重算、再写
public void addSurplusDays(long recordId, int days) {
withLock(lockKey(recordId), () -> { // 累加入口直接有记录编号
UserPackage fresh = packageRepo.findById(recordId); // 锁内重查最新值
fresh.setSurplusDays(fresh.getSurplusDays() + days);
fresh.setPeriodValidity(DateUtils.addDate(
fresh.getStartTime(), fresh.getSurplusDays())); // 与天数同源重算
packageRepo.update(fresh);
});
}
public void activate(long userPkgId) {
UserPackage p = packageRepo.findByUserPkgId(userPkgId); // 先按业务编号找到记录
withLock(lockKey(p.getRecordId()), () -> { // 再按记录编号对齐同一把锁
UserPackage fresh = packageRepo.findById(p.getRecordId()); // 锁内再查,做幂等与最新值校验
if (fresh.isActivated()) return; // 已激活过,直接退出
fresh.setPeriodValidity(DateUtils.addDate(
fresh.getStartTime(), fresh.getSurplusDays())); // 丢弃请求里携带的旧日期
packageRepo.update(fresh);
});
}
// withLock 抢不到锁时抛异常:激活交给消息重试,累加返回失败由前端重试
以上两段为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。UserPackage 是一条用户套餐记录,surplusDays 是剩余天数,periodValidity 是到期日,userPkgId 是业务侧的用户套餐编号,编号与日期均为示意。
下次遇到这些场景要警惕
- 一条记录上有两个互相推导的字段(剩余天数和到期日):先把会写它们的入口和后台任务全部列出来,再对同一用户连续做两次分配,检查每次结束后两个字段是否仍然相等,而不是只看其中一个。
- 写记录的入口是异步处理的:把第一次分配的激活消息延迟消费,在它执行前再提交一次分配,确认迟到的消息不会把新写入的到期日覆盖回旧值。
- 两个入口用不同标识定位同一条记录:一边是记录编号、一边是业务编号时,确认加锁、判重和更新都先换算成同一个标识,并且锁内重新查过最新值。
- 接口参数里带着可以推导出来的时间:检查服务端是否直接采信调用方传来的到期日;应改为用当前最新天数在服务端重算,避免调用方的旧值成为唯一来源。