发生了什么
平台会给用户一段“免时长”:在约定期限内使用服务不收费,这段可以免费使用的时间按天记账。每个用户身上留一条剩余天数,作为这份额度的主记录。
每次给用户分配免时长,系统除了改剩余天数,还会写两份操作明细:一份记在用户名下,一份记在商户名下。后台的分配记录列表读的就是这些明细,一次分配对应一行,商户用它核对每次分配的对象、时间和天数。
正常一次分配应该同时留下三处数据:用户剩余天数、用户操作明细、商户操作明细,三者的天数能对上。这次同一天上午,同一个用户先被分配 1 天,几分钟后又分配 7 天,两次都生效,剩余天数按两次累加。但商户查看分配记录时,只有 1 天那一条,7 天那条查不到,用户名下和商户名下都没有对应的明细。
分配本身生效了,记录却没有留下,后台看到的分配次数和用户实际拿到的天数对不上。
本质
给用户分配免时长的实现后来做过一次服务迁移,新旧两套实现同时在线上跑,由开关决定一次请求走哪一套。判断顺序是:先看一个总开关,打开就直接走新实现;没打开再看用户有没有新版标识,没有就走旧实现;两者都不满足,才按商户和用户的灰度白名单决定。这个总开关可以直接在生产环境修改。
旧实现的做法是:更新用户剩余天数,随后写一条用户操作明细和一条商户操作明细。新实现迁移时只搬了剩余天数的更新,两个明细写入点漏掉了。于是同样一次分配,走旧实现会留下三处数据,走新实现只改剩余天数,明细一条都没有。
同一天两次分配落在两套实现上,结果就一条有明细、一条没有:有记录的那次走的是旧实现,缺失的那次进了还没补写入点的新实现。问题不会以报错的形式出现——剩余天数改成功,接口正常返回,用户也能正常使用;只有去查分配记录时,才会发现这次操作不存在。明细合计与用户剩余天数对不上,出了问题也少了核对这次分配时间和天数的依据。
让问题直接落在生产上的还有开关的优先级。总开关排在灰度白名单前面,一旦打开就直接返回新实现,白名单不再参与判断,灰度实际失去了限制作用。两套实现共行期间,只要总开关被打开,尚未补齐写入点的新实现就会承接生产环境的分配请求。
修复方向是补上两个明细写入点,并收敛放量入口:新实现补齐并通过新旧对照前,只让灰度白名单放量,不让总开关越过白名单。修复上线状态待确认。
错误代码
public void grantFreeTime(GrantCommand command) {
CostFreeTime current = repository.findByUser(command.getUserNewId());
int before = current.getRemainingDays();
current.setRemainingDays(before + command.getDays());
int rows = repository.update(current);
if (rows != 1) {
throw new IllegalStateException("剩余天数更新失败");
}
// 错:旧实现更新完还会写用户、商户两份操作明细,迁移时这两个写入点漏了
// 主记录改成功,分配记录列表就永远查不到这一次分配
}
CostFreeTime 表示用户的免时长剩余天数;GrantCommand 是一次分配请求,含用户标识和本次天数;repository 负责读写剩余天数。代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。
修复代码示例
@Transactional
public void grantFreeTime(GrantCommand command) {
CostFreeTime current = repository.findByUser(command.getUserNewId());
int before = current.getRemainingDays();
int after = before + command.getDays();
current.setRemainingDays(after);
int rows = repository.update(current);
if (rows != 1) {
throw new IllegalStateException("剩余天数更新失败");
}
// 主记录与两份明细在同一事务写入;旧实现也调用同一个方法,迁移时不会再漏
detailWriter.recordGrant(command, before, after);
}
detailWriter.recordGrant 用同一份 before、after 写用户明细和商户明细,两套实现共用,避免下次迁移再各写一套。事务只保证本地写入一起提交;明细写入如果跨服务,还需要补偿或重试保证最终一致。
下次遇到这些场景要警惕
- 把一个已有写操作迁到新服务或新链路:先列旧实现除主记录外的所有副作用,包括操作明细、统计、通知和缓存更新,再逐项在新实现落实;用同一笔业务分别走旧、新实现,比较最终写入的行数和字段,而不是只看接口返回成功。
- 同一功能同时存在总开关和灰度白名单:分别构造“只开总开关”“只开白名单”“都开”三种情况,确认只开总开关不会把未验收的实现推给全量;检查判断顺序里是否有提前返回,让白名单永远走不到。
- 分配、扣减这类带明细的业务:完成后不只查剩余天数,还要按用户和商户分别查操作明细,核对明细条数与天数合计是否和主记录一致;列表、对账和导出都读明细时,三个入口都要对一遍。
- 准备下线旧实现:灰度打到 100% 不等于旧代码可以删;先确认新实现的副作用集合与旧实现完全一致,并保留一段时间的对照数据,再删旧路径。