发生了什么

商户和出租方签一份租赁合同,合同约定租期和每期租金。系统按固定账期把租期切成一段段日期区间,每个区间生成一条租金账单。比如账期按每月 10 日切分,一期是 06-10 到 07-09,下一期是 07-10 到 08-09。账单提前一天生成,所以在 07-09 凌晨这一批任务里,会同时生成当期 06-1007-09 和下期 07-1008-09 两条账单。

合同快到期时,商户会重新签一份合同,把生效日期写在签署当天之前,让合同从更早的一天起算,业务上叫倒签,那个更早的日期就是倒签生效日。倒签之后,新合同的租期会和老合同已经计过费的账期重叠。为了不重复收租,系统在倒签生效时立即生成一条清算账单,把重叠天数对应的租金从老账单里追回来,再按新合同生成后续账单。

这次倒签生效日正好落在账期最后一天,重叠区间出现了。清算账单去找"哪条老账单需要被追回",找到的是当期已经走完的账单 06-10~07-09,只追回了 1 天。老账单剩下的部分没有被冲掉,而新合同又生成了 7 月的账单,两条账单覆盖同一段日期,商户同时收到了新旧两份租金账单。已确认的处理是业务人员手动驳回重复的那条账单。

本质

问题出在"找哪条账单追回"这一步的日期判断上,而不是账单金额算错。

  1. 系统按"倒签生效日落在哪条账单的账期区间内"来匹配目标账单,判断时区间两端都算,结束日 07-09 被当成当期账单里的日子。
  2. 倒签生效日恰好就是当期账单的最后一天,于是匹配命中了 06-10~07-09 这条已经结束的账单。
  3. 清算范围从倒签生效日算到该账单结束日,只剩 1 天,重叠的其余天数没有追回。
  4. 系统接着按新合同生成 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());   // 结束日取下期期末,覆盖整个重叠段
}

下次遇到这些场景要警惕

  • 按日期区间匹配要追回、抵扣或续期的单据:先把区间两端各归哪一期写清楚,再用跨账期当天的输入跑一遍,看命中的是刚结束的那条还是下一期那条。
  • 业务允许倒签、补签、提前生效:把生效日分别放在账期第一天、中间、最后一天和跨月位置各测一次,观察清算单与新账单覆盖的日期是否首尾相接。
  • 调整账期生成规则,比如提前一天生成当期和下期:同时检查依赖"账期区间"做匹配的老代码,确认它不会因为下期账单提前存在而改选目标。