发生了什么
商家后台有一类「权益申请」:平台给商家一笔免时长的权益,约定一段时间内的使用不收费。这笔权益按「批次」登记:一张申请单上可以挂多个免时长批次,每个批次记着免掉的天数;系统按这些批次折算出一个「订单金额」,也就是这笔申请对应的钱数。
申请单里还有一段「开票信息」,是这笔费用开票时要用到的信息,其中开票金额不靠人手填,系统按申请单上当前的免时长批次数据自动算出来。开票信息在一个弹窗里填写,填完点保存,系统就把这一版按草稿存下来,等提交时一起带上去。
正常顺序是:先把免时长批次定好,系统按批次算出订单金额;再打开开票弹窗,系统按同一份批次数据算出开票金额;保存草稿;最后提交,两个金额一致。
这次的操作顺序不同:操作人先把开票信息填完并保存,草稿里存下了当时算出来的开票金额;随后在申请单上更新免时长批次数据,订单金额跟着变了。改完之后,没有任何逻辑去更新草稿里的开票金额,它还是更新批次之前算出来的那个数。点提交时,订单金额按新批次算,开票金额取自草稿,两个数对不上。
结果是这一张申请单上「订单金额」和「开票金额」不一致。记录没有给出这类单子的数量,也没有写后续是退回修改还是人工补齐,只写了这一个现象。
本质
一句话:开票金额本来是从批次数据算出来的派生值,保存草稿时把它连人填的内容一起冻住了;之后来源数据变了,没有人让这份草稿失效,提交时也没有重算,同一张单子上就出现了两个版本的金额。
- 原流程怎么算的。开票金额的唯一来源是当前免时长批次:批次改一次就重算一次,和订单金额同源,正常不会对不上。
- 保存草稿做了什么。点保存时,系统把当时算出来的开票金额和其它开票信息一起存成草稿。草稿本身是必要的,开票信息要能反复修改;问题出在这份草稿后来被提交当成了金额来源。
- 之后来源数据变了。操作人改批次,系统重新算出了订单金额,但改批次这条路径更新了批次和订单金额,没有碰草稿里的开票金额,也没有把草稿标记成已过期。
- 提交这一步错在哪。提交直接读草稿里的金额,没有按当前批次再算一次。于是订单金额来自新批次、开票金额来自旧批次,两个数必然不同。真正的错误动作是「提交时读了冻住的派生值」,而不是「草稿保存了金额」。
- 为什么只有一部分单子会踩到。记录说的触发条件是「保存过开票草稿、之后又更新了免时长批次」;没保存过草稿的单子在提交时没有这份旧值可读,也就带不出更新批次之前的金额。日常按先定批次再填开票信息的顺序操作,正好落在不会出问题的路径上,常规走查里不容易露出来。
由其它数据算出来的金额一旦在保存草稿时被冻住,它就成了一份不会自己更新的旧值;提交时直接读它,同一张单子上就会有两个来源的金额。
记录给出的处理是在提交时做兜底重算:不管开票资料弹窗是否打开、有没有存过草稿,提交这一刻都按当前批次重新算一遍开票金额,把不同入口的情况一起覆盖掉。记录没有写这次改动是否已经上线,也没有写上线后有没有按更新批次的顺序验证过金额已经对平。
错误代码
public class BenefitApplyService {
/** 保存开票信息草稿:把当时算出来的开票金额一起存进草稿 */
public void saveInvoiceDraft(Long applyId, InvoiceDraft draft) {
// 为什么错:金额是从批次汇总来的派生值,存进草稿后就脱离了批次,
// 批次再改,这份草稿也不会跟着变
draft.setInvoiceAmount(calcInvoiceAmount(applyId));
invoiceDraftRepository.save(applyId, draft);
}
/** 提交申请:订单金额按当前批次算,开票金额却直接取草稿 */
public void submit(Long applyId) {
long orderAmount = batchRepository.sumAmount(applyId);
InvoiceDraft draft = invoiceDraftRepository.get(applyId);
// 为什么错:提交时没有再算一次,草稿里是改批次之前的值,
// 同一张单子上的两个金额来自不同版本的批次数据
long invoiceAmount = draft == null ? orderAmount : draft.getInvoiceAmount();
applyRepository.submit(applyId, orderAmount, invoiceAmount);
}
}
修复代码示例
public class BenefitApplyService {
/** 草稿只保留人填的抬头、税号,金额不再作为快照存下来 */
public void saveInvoiceDraft(Long applyId, InvoiceDraft draft) {
draft.setInvoiceAmount(null);
invoiceDraftRepository.save(applyId, draft);
}
/** 提交:开票金额在提交这一刻按当前批次重算,与订单金额同源 */
public void submit(Long applyId) {
long orderAmount = batchRepository.sumAmount(applyId);
// 修复:不再读草稿里的金额。无论之前有没有打开过开票弹窗、
// 有没有存过草稿,这里都重算一次,几条入口最后落到的都是同一份数据
long invoiceAmount = calcInvoiceAmount(applyId);
if (invoiceAmount != orderAmount) {
// 修复:两边都由同一份批次算出,仍不相等说明批次数据或算法有问题,
// 直接失败并带上单号,不要让金额对不上的单子提交出去
throw new InvoiceAmountMismatchException(applyId, orderAmount, invoiceAmount);
}
applyRepository.submit(applyId, orderAmount, invoiceAmount);
}
}
两段代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。记录给出的处理只到「提交时重算」,示例里的相等校验是按同一机制补的一层防护,不是记录中的实际改动。
下次遇到这些场景要警惕
- 表单里有「按其它数据自动算出来」的字段时:先写清这个值来自哪张表、哪几个字段,再构造「先保存这一版、后改来源数据、再提交」的顺序完整走一遍,比较提交时带上去的值与按当前来源算出来的值。
- 给这类派生字段加草稿或暂存能力时:逐个入口走一遍——不打开弹窗直接提交、打开但没保存、保存后又改来源数据——确认三种情况下提交得到的金额都一样;只按正常顺序测,正好绕开有问题的路径。
- 提交动作里同时出现「现算的金额」和「存下来的金额」时:确认两者的来源是同一份数据。只要还有一处读的是存下来的副本,就要么在提交前统一重算,要么在不一致时阻断,别让两个来源同时写进一张单子。
- 接到「金额不符」这类反馈时:先问清操作顺序,看是否存在「先存草稿、后改数据」;再按这个顺序统计同批单子里有多少条是这样产生的。按正常顺序复现不出来,不等于没有问题。