发生了什么
后台给每个账户维护一份“天数池”,池子里按明细记录保存这个账户还能使用多少天。明细上有一个“使用状态”开关,打开表示从当前时刻起可以使用,关闭表示暂停使用。操作人在账户页面上改剩余天数,改的就是某一条明细上的天数。
开关启用时,系统不会原地修改原明细,而是把原来那条置为归档作废,另外生成一条启用状态的新明细,新明细带新的记录编号。正常顺序是:启用成功,页面刷新列表取到新明细的编号和天数,操作人再提交修改,服务端按新编号更新这条生效明细。
这次操作人先点了启用,页面在启用请求返回后约两秒才重新拉列表。就在这两秒里,页面已经调到修改页并读取了数据,但用的是启用前那条明细;操作人提交修改剩余天数后,旧明细的天数被改掉,真正生效的新明细没有变。账户侧看到的就直接是“没有天数”。一个账户充值 30 天后,一周左右就显示没有可用天数,与核对到的请求记录一致。只有操作得足够快才会踩中,所以表现为偶现。
本质
问题不在启用开关本身,而在这条链路里“记录换了编号,页面还拿着旧编号”,前后端各有一处没有兜住。
- 启用动作由后台完成:旧明细被归档作废,新明细生成,编号随之变化。这一步符合设计。
- 页面要等列表刷新才能拿到新编号,而刷新是延迟触发的,中间存在约两秒的空窗期。空窗期内修改按钮仍然可点,也没有任何提示。
- 操作人在这个窗口内提交修改,请求里带的是旧明细的编号。
- 服务端的修改接口按编号查到记录后直接更新天数,没有校验这条记录是否仍然生效,已作废的记录同样能被写入。
- 于是一次修改被写进了归档记录,生效记录保持原值;页面再刷新时读到的仍是新记录的天数,账户显示没有可用天数。
修改按钮还亮着,不代表页面上的数据已经是最新的;状态切换换了记录编号,旧编号的写请求依然会被执行。
修复方向是前后端同时收口。前端在开关操作期间加操作锁并显示加载状态,列表刷新完成或刷新失败后再解锁;期间点修改天数会被阻止并弹出提示,同时补埋点,备注修改也要求解锁后才能操作。服务端在修改接口增加兜底校验,确认请求里的记录编号属于当前生效明细,已作废的记录直接拒绝并返回明确提示。产品已确认这套交互,修复上线状态待确认。
错误代码
// 页面:启用开关后要等列表刷新,但修改按钮没有禁用
void onToggleEnabled(DayDetail row) {
dayPoolClient.enable(row.getId()); // 生成新明细,旧明细归档作废
reloadListLater(); // 约两秒后才刷新列表
}
// 列表还没刷新时,row 仍是旧明细,点修改就带着旧编号提交
void onEditRemainingDays(DayDetail row, int days) {
dayPoolClient.updateDays(row.getId(), days); // 为什么错:启用已换新编号,这里用的还是旧编号
}
// 服务端:按编号直接更新,没有判断记录是否已作废
void updateDays(long detailId, int days) {
DayDetail detail = dayDetailMapper.selectById(detailId);
detail.setRemainingDays(days);
dayDetailMapper.updateById(detail); // 为什么错:没有状态条件,作废记录也会被写入
}
修复代码示例
// 页面:开关请求期间置为刷新中,刷新成功或失败后再解除
volatile boolean refreshing = false;
void onToggleEnabled(DayDetail row) {
refreshing = true; // 加锁并展示加载状态
try {
dayPoolClient.enable(row.getId()); // 后台作废旧明细、生成新明细
reloadList(); // 同步取回新编号与天数
} finally {
refreshing = false; // 失败也要解锁,避免页面卡死
}
}
void onEditRemainingDays(DayDetail row, int days) {
if (refreshing) { // 刷新窗口内拒绝提交
toast("数据更新中,请稍后再改");
return;
}
dayPoolClient.updateDays(row.getId(), days);
}
// 服务端兜底:按编号更新前先校验记录是否仍生效
void updateDays(long detailId, int days) {
DayDetail detail = dayDetailMapper.selectById(detailId);
if (detail == null || !detail.isActive()) throw new BizException("该明细已失效,请刷新后重试");
detail.setRemainingDays(days);
dayDetailMapper.updateById(detail);
}
这里 enable 表示启用开关、updateDays 表示修改剩余天数、isActive 表示明细是否仍为生效状态;编号与状态字段是示意,但“先换编号、后提交修改”的先后关系与事故一致。
下次遇到这些场景要警惕
- 页面上的开关会更换记录编号:在开关提交后、列表刷新完成前,连续点修改、备注、删除,确认这些操作要么被锁住,要么明确落到新记录上。
- 修改接口按记录编号更新:拿一条已作废或已归档记录的编号直接调用,确认接口拒绝并返回可读提示,而不是静默返回成功。
- 用定时器延迟刷新列表:把网络调慢、让刷新失败、快速连点开关,各走一遍,确认页面能解锁并提示,不会一直停在加载中。
- 收到“改了没生效”的反馈:先比对提交时的记录编号和当前生效编号,再看该编号对应的状态,不要只复查修改接口的返回码。