发生了什么
平台与网点之间按租赁合同结算场地租金,合同约定的结算周期决定多久出一期账单。租期被切成一个个结算周期,每个周期对应一张租金账单:账单上记录本期的账期和金额,运营后台按账单结算。账单不是由账单页面直接算出来的,而是由一条“触发器”任务驱动——每条任务记录着一期账单的起止日期,定时任务到点执行,生成账单表里的记录,后台再按账单关系表把账单和金额展示出来。
正常流程是:合同生效后,每一期都有一条触发器任务;到执行时间,任务生成这一期账单,成功后任务结束,账单在后台可查。因此账单能不能生成,既取决于合同里约定的租期,也取决于系统里已经存在的账单数据。
2025 年 5 月做过一次老网点数据迁移,网点本身迁了过来,历史租金账单却没有一起迁。12 月 29 日业务反馈,某网点最后一期租金账单没有生成。查触发器表,任务在、执行时间也已经过去,状态却还是“待执行”,说明这次执行中途出过异常、被回滚了。手动重新执行,看执行日志才发现原因:生成流程判断这笔账单是不是该网点的第一笔时,库里没有更早的账单,于是判成了首笔;首笔会额外按合同开始时间校验账期,校验没有通过,抛出异常,整个生成过程回滚,账单表里没有落下这条记录。
处理时先补迁历史租金账单,再重跑触发器,账单才生成出来。生成完后台仍然查不到,因为后台列表读的是账单关系表,还要把账单和金额在关系表里关联上。排查后确认有 7 个网点受同一批迁移影响,数据已经修复;记录里提到 1 起客诉、影响 1 个用户。代码是否已经改动,记录没有说明。
本质
一句话:程序用“这个网点在库里还没有更早的账单”来判断这是首笔账单,把数据迁移的完整性当成了业务事实;历史账单缺失时最后一期账单被误判成首笔,走进只适用于首期的合同开始时间校验,异常回滚,账单没有生成。
具体过程:
- 正常数据下这个判断成立:首期账单之前没有更早的账单,之后每一期都有。只要历史账单齐全,最后一期不会被当成首笔。
- 迁移只迁了网点,历史租金账单留在老系统里。新系统按网点查“有没有更早的账单”,查不到,就把这笔最后一期账单判成了首笔。
- 首笔分支要按合同开始时间校验账期,这是给首期准备的检查。最后一期账单的账期与合同起租日对不上,校验抛异常。记录没有写具体的校验条件和异常信息,这里只复述“校验合同开始时间后异常”这一步。
- 触发器方法在一个事务里执行,异常把本次执行整体回滚:账单没有写进去,触发器状态也退回待执行。执行时间已经过去,任务却停在待执行,形成“账期到了、账单没有”的缺口。
- 影响不止一笔:同一批迁移的 7 个网点都缺历史账单,都可能被误判。补数据时还要注意后台读的是关系表,只补账单表,页面仍然看不到。
用“库里没有更早的记录”推断业务阶段,等于把迁移是否完整当成了判断条件;迁移漏一批数据,判断就整体走偏。
修复方向是:首笔与否由合同起租日和本期账期直接算出来,不再依赖库里已有账单的数量;迁移完成后按网点核对历史账单是否补齐,缺失的补迁并告警;补出账单后把后台展示所需的关系数据一并补上。记录只给了数据修复过程,代码改动和上线状态没有说明。
下面的代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。
错误代码
// 调度框架把 generate 包在一个事务里执行,抛异常就整体回滚
class RentBillGenerator {
void generate(RentBillTrigger trigger) {
// 为什么错:用“库里有没有更早的账单”判断是不是首笔,
// 等于假设历史账单一定完整;迁移漏数据时这里必然误判
boolean firstBill = rentBillMapper
.countEarlier(trigger.getOutletId(), trigger.getPeriodStart()) == 0;
if (firstBill) {
// 为什么错:首期分支会按合同开始时间校验本期账期,
// 被误判进来的末期账单对不上起租日,校验直接抛异常
firstBillRule.checkContractStart(trigger.getContractId(),
trigger.getPeriodStart());
}
rentBillMapper.insert(buildBill(trigger));
triggerMapper.markExecuted(trigger.getId());
}
}
修复代码示例
class RentBillGenerator {
void generate(RentBillTrigger trigger) {
Contract contract = contractMapper.selectById(trigger.getContractId());
// 修复:首笔只由合同起租日和本期账期决定,
// 本期开始日不晚于起租日才是首期,与库里已有多少账单无关
boolean firstBill = !trigger.getPeriodStart()
.isAfter(contract.getStartDate());
if (firstBill) {
firstBillRule.checkContractStart(trigger.getContractId(),
trigger.getPeriodStart());
}
rentBillMapper.insert(buildBill(trigger));
triggerMapper.markExecuted(trigger.getId());
// 修复后,迁移完整性由迁移脚本和核对任务单独保证,
// 生成流程不再把“库里没有账单”当成业务事实
}
}
下次遇到这些场景要警惕
- 做存量数据迁移时,先列出业务判断依赖的历史数据,比如账单、明细、期次;迁移后按网点或合同核对历史期间的记录条数与合同期数是否一致,再抽查最后一期能否正常生成。
- 看到“按已有记录数”“有没有更早的记录”来推断首笔、首次、是否新客之类的判断,先确认历史数据是否完整;构造“历史记录为空但本期不是首期”的数据,观察是否走错分支。
- 定时任务或触发器停在待执行、执行时间已过时,先查执行日志里的异常,不要直接手工标记成功或反复重跑;重跑前确认数据已经补齐,否则同一异常会重复出现。
- 补生成账单或单据后,同时核对后台列表读取的关联表是否写入,并用业务页面实际查询一次,不要只看主表是否插入成功。