发生了什么
商户和出租方签一份租赁合同,合同约定租期和每期租金。系统按固定账期把租期切成一段段日期区间,每个区间生成一条租金账单。比如账期按每月 10 日切分,一期是 06-10 到 07-09,下一期是 07-10 到 08-09。账单提前一天生成,所以在 07-09 凌晨这一批任务里,会同时生成当期 06-1007-09 和下期 07-1008-09 两条账单。
合同快到期时,商户会重新签一份合同,把生效日期写在签署当天之前,让合同从更早的一天起算,业务上叫倒签,那个更早的日期就是倒签生效日。倒签之后,新合同的租期会和老合同已经计过费的账期重叠。为了不重复收租,系统在倒签生效时立即生成一条清算账单,把重叠天数对应的租金从老账单里追回来,再按新合同生成后续账单。
这次倒签生效日正好落在账期最后一天,重叠区间出现了。清算账单去找"哪条老账单需要被追回",找到的是当期已经走完的账单 06-10~07-09,只追回了 1 天。老账单剩下的部分没有被冲掉,而新合同又生成了 7 月的账单,两条账单覆盖同一段日期,商户同时收到了新旧两份租金账单。已确认的处理是业务人员手动驳回重复的那条账单。
本质
问题出在"找哪条账单追回"这一步的日期判断上,而不是账单金额算错。
- 系统按"倒签生效日落在哪条账单的账期区间内"来匹配目标账单,判断时区间两端都算,结束日 07-09 被当成当期账单里的日子。
- 倒签生效日恰好就是当期账单的最后一天,于是匹配命中了 06-10~07-09 这条已经结束的账单。
- 清算范围从倒签生效日算到该账单结束日,只剩 1 天,重叠的其余天数没有追回。
- 系统接着按新合同生成 7 月账单,覆盖的日期与没被追回的老账单重叠,商户就看到两份同时有效的租金账单。
这里容易被忽略的是,账单提前一天生成,下一期账单在倒签发生前就已经存在了。也就是说,候选账单里同时有两条可选:一条刚结束,一条还没开始。判断条件只要把结束日算进当期,倒签生效日就会选到那条刚结束的账单,而它恰好是清算不该追的那一条。
预期的行为是:倒签后应该匹配下期账单 07-10~08-09,追回从倒签生效日到该期结束的租金,这样两段账期首尾相接、不重叠。
账期区间的结束日本身属于当期,倒签生效日正好压在结束日上,清算于是追了一条已经走完的账单。
修复方向是调整查找规则:定位目标账单时改用倒签生效日的次日,让次日落到下一期;清算的起始日仍按倒签生效日计算。下面的代码是脱敏教学示例,用于说明这个判断边界,不代表实际项目源码或已上线实现。
错误代码
// 教学示例:按“倒签生效日落在哪个账期”找需要追回的账单
Bill findBillToRecover(long merchantId, LocalDate backdateDay) {
List<Bill> bills = billRepo.listGenerated(merchantId);
for (Bill bill : bills) {
// 为什么错:起止日两头都算,账期最后一天同时算在当期里
boolean hit = !backdateDay.isBefore(bill.getPeriodStart())
&& !backdateDay.isAfter(bill.getPeriodEnd());
if (hit) {
// 命中已走完的当期账单,清算只覆盖最后 1 天
return bill;
}
}
throw new IllegalStateException("no bill to recover");
}
// 倒签生效时按匹配结果生成清算账单
Bill settle(Bill oldBill, LocalDate backdateDay) {
return billService.createSettleBill(
oldBill.getMerchantId(),
backdateDay, // 清算起始日
oldBill.getPeriodEnd()); // 清算结束日,重叠的大部分天数就这样丢了
}
修复代码示例
// 修复方向:定位目标账单时用倒签生效日的次日,清算起始日仍按倒签生效日
Bill findBillToRecover(long merchantId, LocalDate backdateDay) {
LocalDate lookupDay = backdateDay.plusDays(1); // 次日落在下一期,不再命中刚结束的账期
List<Bill> bills = billRepo.listGenerated(merchantId);
for (Bill bill : bills) {
boolean hit = !lookupDay.isBefore(bill.getPeriodStart())
&& !lookupDay.isAfter(bill.getPeriodEnd());
if (hit) {
return bill; // 追回的是下期账单
}
}
throw new IllegalStateException("no bill to recover");
}
Bill settle(Bill targetBill, LocalDate backdateDay) {
return billService.createSettleBill(
targetBill.getMerchantId(),
backdateDay, // 起始日不变
targetBill.getPeriodEnd()); // 结束日取下期期末,覆盖整个重叠段
}
下次遇到这些场景要警惕
- 按日期区间匹配要追回、抵扣或续期的单据:先把区间两端各归哪一期写清楚,再用跨账期当天的输入跑一遍,看命中的是刚结束的那条还是下一期那条。
- 业务允许倒签、补签、提前生效:把生效日分别放在账期第一天、中间、最后一天和跨月位置各测一次,观察清算单与新账单覆盖的日期是否首尾相接。
- 调整账期生成规则,比如提前一天生成当期和下期:同时检查依赖"账期区间"做匹配的老代码,确认它不会因为下期账单提前存在而改选目标。