发生了什么

网点的租赁合同生效后,系统把租期切成一个个结算周期,每个周期生成一张租金账单;合同重签时,还要生成一张清算账单,把变更前那段租期的费用结清。这个网点的结算周期是月付。

账单不是到点自己算,而是由触发器驱动。触发器是一条待执行的任务记录,里面存着这一期要计算的起止日期;定时任务每天扫描,到点就执行,执行成功把触发器置为「已执行」,失败则退回「待执行」,等下一轮再跑。执行时用结束日减开始日得到自然天数,再把这一期金额按天数摊成日租金,生成账单。

正常情况下,首期区间的开始日和结束日锚在同一个起点:开始日是本期第一天,结束日是最后一天,天数至少为一天。这一次,4 月 30 日系统里完成了重签,新租期起始日写的是 4 月 30 日,但合同实际签字完成是 5 月 30 日,纸面租期比实际签字早了一整月,业务上叫倒签。新起始日 4 月 30 日又早于老合同的结束日 5 月 27 日,重签因此走了「与老租期重叠、且属于倒签」的分支。这个分支给首期触发器算区间时,开始日取实际签字日 5 月 30 日,结束日却按名义起始日 4 月 30 日加一个月再减一天,得到 5 月 29 日。两端起算点不同,开始日反而比结束日晚一天。

触发器按这个区间执行,自然天数是 0,金额除以 0 直接抛异常。触发器的方法是事务性的,异常回滚后状态退回「待执行」;第二天定时任务再跑,还是同一段区间、同一个除零,每天重复。于是重签后该出的清算账单没有出来,后续正常的租金账单也一张都没有生成,只剩每天重复的失败告警。

本质

一句话:首期账期的开始日锚在「实际签字日」,结束日锚在「合同名义起始日」,倒签满一个结算周期时两个锚点互相跨过,区间变成 0 天,除法崩溃;触发器又被事务回滚反复重试,账单就永久卡住。

具体过程:

  1. 正常算法:重签时首期从本期第一天算到最后一天,天数大于 0,按天数摊出日租金,触发器执行成功并置为已执行,账单落库。
  2. 这次命中的分支:新租期起始 4 月 30 日与老合同结束 5 月 27 日重叠,且起始日早于实际签字日 5 月 30 日,属于「有重叠倒签」。分支里开始日跟着签字日走,结束日跟着合同名义起始日走。
  3. 区间为什么反过来:倒签不足一个结算周期时,名义首期还有一部分落在签字日之后,两端能夹出正数区间;倒签满一个周期后,名义首期整段落在签字日之前,开始日就排到结束日后面。本例 5 月 30 日就晚于 5 月 29 日。
  4. 0 天为什么让账单彻底不出:日租金等于金额除以自然天数,天数为 0 时抛算术异常。触发器带事务,异常回滚使本次执行结果不落库,状态退回待执行;定时任务每天重跑、每天在同一行再崩一次,账单一直无法生成。
  5. 怎么处理:给出的处置是订正这条触发器的起止日期后立即重跑,补出首期租金账单;清算账单对应的触发器单独确认后一并重跑,并核对触发器变为已执行、两类账单都出现。代码侧修改首期结束日的推算,对天数为 0 的情况加防御,并补「首尾同一天」「开始晚于结束」的单测。给出的结论是账期问题已在 6 月初修正上线、这张账单已重新补充;补出的账单是否覆盖全部同类网点,材料没有说明。

开始日锚在签字日、结束日锚在合同起始日,倒签满一个周期时区间会变成 0 天,一次除零就把触发器一直卡在重试里。

修复方向是两处:首期结束日改用「名义起始日与实际签字日的较晚者」推算,保证结束日不早于开始日;按天数摊销的地方对天数小于等于 0 做防御,不让一次异常回滚把任务卡死在待执行。需要补的回归是倒签正好跨满一个结算周期、首尾同一天、开始晚于结束这三种区间。下面的代码是脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。

错误代码

class RentBillFlow {

    /** 重签「有重叠倒签」分支:给首期租金触发器写执行区间 */
    void buildFirstRentPeriod(Date signDate, Date leaseStart, BillingCycle cycle) {
        Date startCalDate = signDate;                          // 锚在“实际签字日”
        Date endCalDate = getFirstPeriodEnd(leaseStart, cycle); // 锚在“合同起始日”,4-30 加一个月减一天
        // 为什么错:两端用了不同的起算点。倒签满一个周期时
        // startCalDate(5-30) 已晚于 endCalDate(5-29),这里没有做任何校验
        triggerParam.setCalDate(startCalDate, endCalDate);
    }

    /** 触发器执行:按区间自然天数摊日租金 */
    BigDecimal calcDailyRentMoney(BigDecimal amountMoney) {
        int naturalDays = daysBetween(startCalDate, endCalDate); // 5-30 到 5-29,得 0
        // 为什么错:天数为 0 仍直接做除法,抛 ArithmeticException;
        // 事务回滚让触发器退回待执行,定时任务每天重跑、每天再崩一次
        return amountMoney.divide(new BigDecimal(naturalDays), 2, RoundingMode.HALF_UP);
    }
}

修复代码示例

class RentBillFlow {

    void buildFirstRentPeriod(Date signDate, Date leaseStart, BillingCycle cycle) {
        Date startCalDate = signDate;
        // 首期末从“名义起始日与实际签字日的较晚者”起算:
        // 倒签时以实际签字日为起点,结束日自然落在开始日之后
        Date periodStart = laterOf(leaseStart, signDate);
        Date endCalDate = getFirstPeriodEnd(periodStart, cycle);
        triggerParam.setCalDate(startCalDate, endCalDate);
    }

    BigDecimal calcDailyRentMoney(BigDecimal amountMoney) {
        int naturalDays = daysBetween(startCalDate, endCalDate);
        if (naturalDays <= 0) {
            // 兜底不做除零:正常路径已由上面的区间修正保证天数大于 0,
            // 这里只拦异常数据,避免一次执行失败把触发器永久卡在待执行
            naturalDays = 1;
        }
        return amountMoney.divide(new BigDecimal(naturalDays), 2, RoundingMode.HALF_UP);
    }
}

下次遇到这些场景要警惕

  1. 合同起始日早于实际签字日时,按「倒签满一个结算周期」构造数据各跑一单:月付造滞后一个月、季付造滞后三个月,核对首期触发器的开始日是否早于结束日,再实际执行一次,确认账单能落库且触发器变为已执行。
  2. 改动任何「按起止日期算天数再摊销」的账期逻辑时,把开始等于结束、开始晚于结束、跨月、月末当天回填这几种区间列成表跑一遍,确认没有裸除法,也确认非法区间在生成账单前就被拦住。
  3. 触发器停在待执行并每天重复告警时,先看告警里是不是同一个异常反复出现,再去查触发器里存的起止日期,不要只重启任务或手工标记已执行——那会把算反的区间原样留在数据里,下一轮照样崩。
  4. 补完数据要两头核对:清算账单和首期租金账单都出现、两个触发器都变为已执行;再按「倒签滞后不少于一个结算周期 + 触发器待执行 + 除零告警」扫一遍同类网点,统一处理。