发生了什么
网点是平台租下场地经营的门店,要按月向场地方付租金,用电再按实际用量付电费。这两笔钱都靠系统出账单,运营按账单和网点结算,账单本身就是收付款依据。
账单不是人工点按钮生成的,而是由合同上排好的任务记录驱动。网点录入合同并生效时,系统按合同约定的结算周期排出一串任务,每条任务记着“哪份合同、哪一期、哪天执行”。到了那天,定时调度扫出当天到期的任务,逐条生成对应账单,账单写进账单表,后台按账单列表展示并结算。也就是说,任务在,账单才在。
正常续签是这样:老合同快到期,网点和场地方再签一份新合同。新合同生效后,系统按新合同重新排后续账期的任务;老合同那边,为了让它在剩余期间不再出账,合同变更的处理会把这些任务失效掉,免得同一期按两份合同各出一张账单。
出问题的那个网点,续签那天正好是每月第一天,而每月第一天也是电费任务的固定执行日。当天,合同变更和电费出账两件事撞在一起,合同变更先执行。它把老合同名下的任务失效掉时,做法是直接删除这些任务记录,删除只按合同匹配,没有看每条任务的执行日期,于是当天要执行的那条电费任务也被删掉了。等到出账时间,调度按“今天到期的任务”去查,已经查不到这条任务,当天的电费账单没有任何记录,后台也看不到异常账单——不是账单生成失败,而是根本没有人去生成它。
这次缺账单共约三百单,是多条原因叠加的结果,这里说的是其中一类:续签当天的出账任务在合同变更时被删掉。已确认没有资金损失,也不需要给网点补偿,把缺的账单补出来即可。
本质
一句话:合同变更用“删除老合同全部任务”来实现失效,把当天已到期、还没执行的那条也删了;而账单只能由任务驱动生成,任务没了就永远不会出账。
- 原流程。账单只能由任务驱动生成:合同生效时排出任务,每条带着合同、账期和执行日期;调度每天扫到期任务,逐条生成账单。整个过程只认任务记录,出账这一步由任务在不在决定。
- 失效的做法。合同变更里为了让老合同不再出账,直接按合同删除任务记录。删除条件只写了合同,没有加“执行日期晚于变更日”或“尚未出账”这样的边界。
- 撞在一起。同一天有两个动作:合同变更和电费出账。合同变更先跑,删除发生在出账之前,而被删的正是当天要到期的任务,它挂在老合同名下。
- 结果。出账时按当天日期查任务,查不到已经被删除的记录,这一期就没有账单;因为账单是“有任务才有”,缺失既不会自愈,也不会留下失败记录。
- 为什么没被拦住。失效动作只看合同、不看执行日期,这是唯一一道关卡;一旦变更日和出账日撞在同一天,当天要跑的任务就被当成老合同的任务处理掉。账单缺失之后既没有对账也没有告警,业务不反馈就没人知道。
用删除任务来表达“失效”,等于把“这一期该不该出账”的唯一凭据一起删掉了。
修复方向是调整执行顺序:让当天到期的电费任务先出账,再做合同变更,并在失效时只处理变更日之后的任务。修复上线状态待确认。
错误代码
// 合同续签:失效老合同的任务,并按新合同排后续账期(脱敏教学示例)
@Service
public class ContractRenewService {
@Transactional
public void renew(Long oldContractId, Long newContractId, LocalDate changeDate) {
// 为什么错:只按合同删除任务,没看执行日期,当天已到期的那条也被删掉
triggerMapper.deleteByContractId(oldContractId);
// 按新合同排后续账期的任务
triggerMapper.createForContract(newContractId, changeDate);
}
}
// 出账调度:每天扫出当天到期的任务,逐条生成账单
@Scheduled(cron = "0 0 2 * * ?")
public void generateDueBills() {
for (BillTrigger trigger : triggerMapper.selectDue(LocalDate.now())) {
billService.generate(trigger); // 为什么错:任务已被删,这天什么都不会生成
}
}
修复代码示例
@Service
public class ContractRenewService {
@Transactional
public void renew(Long oldContractId, Long newContractId, LocalDate changeDate) {
// 修复:先把当天到期、还没出账的任务执行完,让这一期账单先落地
billService.generateDueFor(oldContractId, changeDate);
// 修复:只失效变更日之后的任务,当天及以前的任务留给上面结算
triggerMapper.deleteAfter(oldContractId, changeDate);
triggerMapper.createForContract(newContractId, changeDate);
}
}
// 调度逻辑不变;generateDueFor 只处理未出账任务,出账后置为已出账,不会重复生成
@Scheduled(cron = "0 0 2 * * ?")
public void generateDueBills() {
for (BillTrigger trigger : triggerMapper.selectDue(LocalDate.now())) {
billService.generate(trigger);
}
}
下次遇到这些场景要警惕
- 合同变更、作废或过期要停掉关联的定时任务时:先按执行日期列出“今天已到期、还没出账”的任务,确认这次失效会不会把它们带走;改完后在变更当天等到出账时间,检查这一期账单是否照常生成。
- 同一天既有出账批处理、又有改合同数据的操作时:把合同生效日或变更日故意设成出账当天造一条用例,跑完看这一期账单是否齐全,而不是只看新合同后续账期有没有出账。
- 用“删除”表达“失效”的地方:换成带状态的失效标记,或者至少保留可查询的失效记录,让“这一期出过账没有”事后能核对,而不是删完就无迹可查。
- 每天出账之后:按“应出账的合同和账期”与“实际生成的账单”做一次对账,缺账单要能报警,而不是等商户发现后回头查。