发生了什么
网点是平台租场地经营的场所,一个网点一份租赁合同。合同上有一个“支付对象”,指租金实际付给谁:通常是房东,也可以由房东指定为另一家公司。系统按账期生成租金账单,生成时把当时的支付对象写进账单,后续打款和核对都以它为准。
正常流程是:账单逐期生成,生成时从合同的当前版本(业务上叫合同快照)取支付对象。合同中途换支付对象时,历史账单不跟着改——那一期的钱是按原主体结算的,只有之后新生成的账单用新主体。合同终止时,系统还会生成一张租金清算账单,把终止时还没结清的租金单独结一张,它要先通过核对才能继续走结算。
这次不同在于合同在租期中间换过支付对象。10 月,网点把支付对象从原主体改成新主体,合同快照同步更新,此前已生成的租金账单仍记着原主体。1 月上旬签了终止协议,两天后系统生成清算账单,支付对象直接抄了最近一张租金账单,也就是原主体。核对环节拿它跟合同快照比,快照上已是新主体,于是提示“房东或支付对象名称不一致”,核对不通过。
实际处置是按业务确认的支付对象订正合同快照上的编号,两边一致后重新核对。这只是单条数据订正,没有改变生成和核对各取一处的结构。
本质
- 账单生成环节只管当期:把支付对象落在账单上,作为这张账单的固定属性。合同改约只影响之后新生成的账单,历史账单保持原样——否则改约会把已按原主体结算的账单一起改掉。
- 清算账单走另一条链路:不按账期生成,而是终止时生成一次,取数复用“最近一张租金账单”的支付对象,不读合同当前版本。改约在账单生成之后、终止之前,于是它拿到的是改约前的主体。
- 核对环节用第三个来源:不读清算账单的生成记录,而是读合同快照上的当前支付对象再比。生成抄历史单据、核对读当前快照,只要最后一张账单生成时用的还是旧主体,两边就不一致。
- 缺的是“清算账单该取哪一版支付对象”的口径:按终止时合同主体,还是按历史账单原主体收款,没有落成规则;账单没记录取自哪一版,核对只能默认“与当前快照一致”,生成逻辑取到历史来源时就会误报。
结果是这张清算账单停在核对不通过,要人工订正数据才能继续;记录里没有金额、资损和付款状态,能确认的只有核对被拦住。同一份合同的支付对象被三个环节按三个时点读取,却没有一处记录用的是哪一版。
修复方向是:先定清算账单支付对象的口径,让生成和核对使用同一来源;生成时把支付对象及来源版本写进账单,核对按记录的版本判断;存量不一致数据订正一次,并补一条生成后的一致性巡检。修复上线状态待确认。
下面两段是脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。
错误代码
// 生成租金清算账单
public ClearingBill createClearingBill(long contractId) {
// 清算金额以最近一张租金账单为基数
RentBill lastBill = rentBillMapper.selectLatestByContract(contractId);
ClearingBill bill = new ClearingBill();
bill.setContractId(contractId);
// 为什么错:支付对象抄的是改约前生成的历史账单,
// 核对却读改约后的合同快照,两边必然对不上
bill.setPayeeId(lastBill.getPayeeId());
bill.setAmount(settleService.calcRemain(contractId));
clearingBillMapper.insert(bill);
return bill;
}
// 清算核对:拿账单支付对象与合同快照比较
public CheckResult check(ClearingBill bill) {
ContractSnapshot snap = snapshotMapper.selectCurrent(bill.getContractId());
if (!Objects.equals(bill.getPayeeId(), snap.getPayeeId())) {
// 为什么错:校验假定生成时用的是当前快照,实际取的是历史账单,
// 两处口径不同,改约过的合同必然报错
return CheckResult.fail("房东或支付对象名称不一致");
}
return CheckResult.pass();
}
修复代码示例
// 按“清算取终止时合同主体”落库,并记录来源版本
public ClearingBill createClearingBill(long contractId) {
ContractSnapshot snap = snapshotMapper.selectCurrent(contractId);
ClearingBill bill = new ClearingBill();
bill.setContractId(contractId);
// 为什么这样改:生成改用合同当前版本,与核对同源;
// 若业务定的是历史账单主体,这里换成对应来源,核对按来源分支处理
bill.setPayeeId(snap.getPayeeId());
bill.setPayeeSource(PayeeSource.CONTRACT_CURRENT);
bill.setPayeeVersion(snap.getVersion());
bill.setAmount(settleService.calcRemain(contractId));
clearingBillMapper.insert(bill);
return bill;
}
// 核对按账单记录的来源和版本判断,不读当前快照
public CheckResult check(ClearingBill bill) {
if (bill.getPayeeSource() == PayeeSource.CONTRACT_CURRENT) {
ContractSnapshot snap = snapshotMapper.selectByVersion(
bill.getContractId(), bill.getPayeeVersion());
if (snap == null || !Objects.equals(bill.getPayeeId(), snap.getPayeeId())) {
return CheckResult.fail("账单支付对象与生成时合同版本不一致");
}
return CheckResult.pass();
}
// 已按历史账单口径生成的存量单,回查原账单再比
RentBill origin = rentBillMapper.selectById(bill.getOriginBillId());
return Objects.equals(bill.getPayeeId(), origin.getPayeeId())
? CheckResult.pass() : CheckResult.fail("账单支付对象与原始账单不一致");
}
关键是生成和校验认同一份来源,并把口径写到账单上;只订正一条数据,同类合同下次终止还会再卡一次。
下次遇到这些场景要警惕
- 给账单类单据增加“从别的单据复制字段”的逻辑:先列出该字段在源单据上被修改的所有入口:合同改约、数据订正、批量修数;再构造“改约之后才生成派生单据”的场景,看派生值与核对口径是否一致。
- 新增加一个“生成后立即核对”的环节:把生成和核对的取数来源并排写出来,确认两边读同一版本;只用未改约的合同跑通,等于没测这条路径。
- 合同中途改过主体、事后要终止的存量数据:挑一张改过支付对象的合同走到终止,分别检查清算账单、合同快照、最近一期租金账单上的支付对象,确认三者的时点关系符合业务口径,而不是碰巧相等。
- 用订正数据暂时放过一次核对之后:补一条生成后的一致性巡检,按“账单记录的来源版本与取值是否匹配”定期比对,不一致时主动告警,而不是等下次核对失败。