发生了什么
网点的租赁合同生效后,系统把租期切成一个个结算周期,每个周期生成一张租金账单;合同重签时,还要生成一张清算账单,把变更前那段租期的费用结清。这个网点的结算周期是月付。
账单不是到点自己算,而是由触发器驱动。触发器是一条待执行的任务记录,里面存着这一期要计算的起止日期;定时任务每天扫描,到点就执行,执行成功把触发器置为「已执行」,失败则退回「待执行」,等下一轮再跑。执行时用结束日减开始日得到自然天数,再把这一期金额按天数摊成日租金,生成账单。
正常情况下,首期区间的开始日和结束日锚在同一个起点:开始日是本期第一天,结束日是最后一天,天数至少为一天。这一次,4 月 30 日系统里完成了重签,新租期起始日写的是 4 月 30 日,但合同实际签字完成是 5 月 30 日,纸面租期比实际签字早了一整月,业务上叫倒签。新起始日 4 月 30 日又早于老合同的结束日 5 月 27 日,重签因此走了「与老租期重叠、且属于倒签」的分支。这个分支给首期触发器算区间时,开始日取实际签字日 5 月 30 日,结束日却按名义起始日 4 月 30 日加一个月再减一天,得到 5 月 29 日。两端起算点不同,开始日反而比结束日晚一天。
触发器按这个区间执行,自然天数是 0,金额除以 0 直接抛异常。触发器的方法是事务性的,异常回滚后状态退回「待执行」;第二天定时任务再跑,还是同一段区间、同一个除零,每天重复。于是重签后该出的清算账单没有出来,后续正常的租金账单也一张都没有生成,只剩每天重复的失败告警。
本质
一句话:首期账期的开始日锚在「实际签字日」,结束日锚在「合同名义起始日」,倒签满一个结算周期时两个锚点互相跨过,区间变成 0 天,除法崩溃;触发器又被事务回滚反复重试,账单就永久卡住。
具体过程:
- 正常算法:重签时首期从本期第一天算到最后一天,天数大于 0,按天数摊出日租金,触发器执行成功并置为已执行,账单落库。
- 这次命中的分支:新租期起始 4 月 30 日与老合同结束 5 月 27 日重叠,且起始日早于实际签字日 5 月 30 日,属于「有重叠倒签」。分支里开始日跟着签字日走,结束日跟着合同名义起始日走。
- 区间为什么反过来:倒签不足一个结算周期时,名义首期还有一部分落在签字日之后,两端能夹出正数区间;倒签满一个周期后,名义首期整段落在签字日之前,开始日就排到结束日后面。本例 5 月 30 日就晚于 5 月 29 日。
- 0 天为什么让账单彻底不出:日租金等于金额除以自然天数,天数为 0 时抛算术异常。触发器带事务,异常回滚使本次执行结果不落库,状态退回待执行;定时任务每天重跑、每天在同一行再崩一次,账单一直无法生成。
- 怎么处理:给出的处置是订正这条触发器的起止日期后立即重跑,补出首期租金账单;清算账单对应的触发器单独确认后一并重跑,并核对触发器变为已执行、两类账单都出现。代码侧修改首期结束日的推算,对天数为 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);
}
}
下次遇到这些场景要警惕
- 合同起始日早于实际签字日时,按「倒签满一个结算周期」构造数据各跑一单:月付造滞后一个月、季付造滞后三个月,核对首期触发器的开始日是否早于结束日,再实际执行一次,确认账单能落库且触发器变为已执行。
- 改动任何「按起止日期算天数再摊销」的账期逻辑时,把开始等于结束、开始晚于结束、跨月、月末当天回填这几种区间列成表跑一遍,确认没有裸除法,也确认非法区间在生成账单前就被拦住。
- 触发器停在待执行并每天重复告警时,先看告警里是不是同一个异常反复出现,再去查触发器里存的起止日期,不要只重启任务或手工标记已执行——那会把算反的区间原样留在数据里,下一轮照样崩。
- 补完数据要两头核对:清算账单和首期租金账单都出现、两个触发器都变为已执行;再按「倒签滞后不少于一个结算周期 + 触发器待执行 + 除零告警」扫一遍同类网点,统一处理。