发生了什么
平台把网点经营中产生的租金和电费,按月做成一张张账单。账单是结算的最小单位:一张账单对应一笔应收的钱,核对完成后,系统按这张账单上的金额调用下游打款接口,把钱付出去。
账单上的金额不是只有一个数,而是随流程分三段保存,每段都有一对“金额 + 含税金额”:
- 申请金额:系统按合同和用量生成账单时写进去的原始金额;
- 审批金额:审核环节由审核人确认,金额有问题可以直接改;改过之后,审批金额和申请金额就不一样了;
- 核对金额:核对环节写入,是这笔账最终交给下游的金额。
正常顺序是:系统生成账单(申请)→ 审核确认或调整(审批)→ 核对(核对金额按审批金额落定)→ 核对后调用下游打款接口。越靠后的环节越接近最终付款,所以核对必须以审批金额为准,不能拿生成时的申请金额重新算一遍。
这次不一样的地方在核对:一条电费账单审核时把审批金额从 100 调到了 105(示意金额),随后操作“批量核对”,再回来看这张账单,核对金额又变成了 100。页面上看到的是修改前的数,审核那一改等于没发生。
原因是批量核对在写核对金额时,取的是申请金额,不是审批金额。审核没有改过金额的账单,两个值本来就相同,所以看不出问题;只有“审核改过金额”的账单,核对后才对不上。批量核对一次处理一批账单,凡是这批里审核改过金额的,都会被写成申请金额。
核对金额是交给下游打款的金额,因此这张账单最终交出去的仍然是 100,审核确认的 105 没有进入下游请求。
本质
- 业务上已经用字段把“哪个金额有效”表达清楚了:审批金额是审核人确认后的结果,核对只是把它落到最终结算字段上。核对环节的职责是确认并落地,不是重新算一遍。
- 批量核对的实现按账单编号一次查出多条账单,逐条把申请金额、申请含税金额赋给核对金额、核对含税金额,再把状态改成已核对。这一步没有判断审批金额是否存在,也没有判断它和申请金额是否不同。
- 对审核时改过金额的账单,申请金额保持生成时的数值,审批金额是改后的数值。批量核对用申请金额覆盖核对金额后,核对结果回到审核之前;被改的只是核对字段,审批记录本身没有动。
- 覆盖发生在核对环节,页面和下游读的都是覆盖后的核对金额,所以从结果上看就是“审核改过的金额又变回去了”。问题随批次放大:一次勾选多少张,其中的改过金额账单都会被覆盖。
- 记录里的处理是修改批量核对时的取值逻辑。修复方向是让核对金额、核对含税金额都取审批口径;审批金额为空时直接失败,不用申请金额顶上;这样重复核对同一张账单也得到同一个结果。
同一条账单上并存申请、审批、核对三个金额版本,核对却取了最早的那个,审核的调整在最后一步被覆盖。
代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。
错误代码
public class BillVerifyService {
/** 批量核对:按账单编号一次查出多条,逐条写入核对金额 */
public int batchVerify(List<Long> billIds) {
List<Bill> bills = billMapper.selectByIds(billIds);
for (Bill bill : bills) {
// 为什么错:核对金额取的是系统生成时的申请金额,
// 审核环节改过的审批金额被绕过
bill.setVerifyAmount(bill.getApplyAmount());
bill.setVerifyTaxAmount(bill.getApplyTaxAmount());
bill.setVerifyStatus(VerifyStatus.DONE);
billMapper.updateVerifyAmount(bill);
}
return bills.size();
}
}
修复代码示例
public class BillVerifyService {
public int batchVerify(List<Long> billIds) {
List<Bill> bills = billMapper.selectByIds(billIds);
for (Bill bill : bills) {
// 核对是结算的最后一步,必须沿用审核确认后的金额;
// 审批金额为空说明这张账单还没审核完,不能核对
if (bill.getApproveAmount() == null) {
throw new IllegalStateException(
"账单缺少审批金额,不能核对: " + bill.getId());
}
// 金额与含税金额同源,一起改用审批口径
bill.setVerifyAmount(bill.getApproveAmount());
bill.setVerifyTaxAmount(bill.getApproveTaxAmount());
bill.setVerifyStatus(VerifyStatus.DONE);
billMapper.updateVerifyAmount(bill);
}
return bills.size();
}
}
下次遇到这些场景要警惕
- 一个业务对象上并存多个版本的金额时:先列出每个金额字段由哪个环节写入、哪个环节读取,再逐个写入点核对来源。构造一张“审核改过金额”的账单走完核对,比较核对金额与审批金额是否一致。
- 单条核对与批量核对是两份实现时:对同一张已改过金额的账单分别执行两个入口,比较两次的核对金额和下游请求金额。批量入口常复用列表查询的字段,容易拿到给列表展示用的旧值。
- 批量操作上线前:准备两类数据——审核未改金额、审核改过金额——各跑一遍。前者两个金额相同,错误会被掩盖,只有后者能暴露取值来源错位。
- 核对结果会进入下游打款时:调用下游前校验“审批金额 = 核对金额”,含税金额按同一口径比较,不一致就阻断并告警,不要只信核对结果。