发生了什么

网点租用场地经营,按月向平台付场地租金。每个账期对应一张租金账单,账单上记录本期账期和金额,运营在后台按账单走审批和结算。账单不是人工填的,而是由一条按账期排好的"租金账单生成任务"(记录里叫触发器)驱动:时间到了自动执行,在账单表里写一条账单记录,并写一张按月份分开的临时表,再把账单 id、所属合同和金额登记到账单关系表。后台的账单审批列表读的不是账单表,而是这张关系表——关系表里有这条记录,审批才搜得到这笔账单。

正常顺序是:账期到了,任务自动执行,账单表、临时表、关系表三处都写成功,运营在后台查得到账单并完成审批。

这个网点 6 月的账单没有生成,记录只说该月任务的执行因数据原因没有成功,没有写具体卡在哪一步。到了第二年 1 月,运营反馈后台搜不到这笔账单的审批,研发通过后台运维入口手工执行同一条任务,把这个账期的账单补生成出来。

补生成的结果一半对一半不对:账单表写进去了,业务系统的账单页面能看到这笔账单;但任务接着写的临时表是按月份分开的,这次补的是半年前的账期,落到 6 月那张临时表上,间隔太久,这张临时表已经写不进去,写入时报错,排在它后面的关系表也没有写。账单表有记录、关系表没有,审批列表按关系表查,就搜不到这笔账单。

当时的处理是人工往关系表里补一条记录,把账单 id 和账单金额关联上,补完后后台按网点能搜到这笔账单。记录没有写这次涉及几笔账单,也没有写同批补数的网点是否都核对过。

本质

一句话:补历史账单复用了在线生成流程,而这条流程把"写账单表""写当月临时表""写关系表"按顺序串在一起,偏偏最后一步才决定审批能否看到;中间那步对老账期不成立,把后面那步一起带断,先写进去的账单也没有撤回。

  1. 自动流程能成立,前提是当月执行当月账期:临时表按月份准备,当月账期一定写得进去,写完再写关系表,三步都能过。
  2. 手工补数打破了这个前提:账期是半年前的 6 月,对应的临时表已经不能写入,写入报错。
  3. 三步是顺序依赖的:第二步抛错,第三步关系表就不再执行;而从结果看,账单表那一步已经生效、没有跟着回滚。
  4. 于是留下一条不完整的记录:账单真实存在、金额也算出来了,审批页面读的关系表里却没有它。这种部分写入没有补偿,补数后也没有按账单反查关系,只能等运营反馈才发现。

账单写进去了、关系表没写,审批就读不到;写入顺序里只要有一步失败而主记录已经生效,就会留下一条业务上查不到的账单。

修复方向是:把决定业务可见性的账单表和关系表放进同一个本地事务,先写关系表,再写不参与审批展示的临时表;补历史账期前先确认目标月份的临时表可写,不可写就直接失败,不留半条数据;补数完成后按账单 id 反查关系表,确认每笔账单都有关联。存量数据要按补数批次核对关联是否齐全,不能只补账单表。记录里只做了人工补关联这一临时处理,代码是否改动、修复是否上线都没有说明。

下面两段是脱敏教学示例,用于说明错误与修复思路,不代表实际项目源码或已上线实现(Java 教学示例)。

错误代码

class RentBillGenerator {
    // 三步写入各自生效:前一步成功,后面的步骤失败也不会撤回已写入的账单
    void generate(BillPeriod period, Long contractId) {
        Long billId = billMapper.insert(period.toBill(contractId));
        // 为什么错:临时表按月份分开,补半年前的账期时该月临时表已不可写,
        // 这一步抛错会中断方法,后面的关系记录再也写不进去
        tempTableMapper.insert(period.getMonth(), billId);
        // 为什么错:审批页面只读这张关系表,这行依赖上一步成功;
        // 上一步报错时它不执行,也没有补偿,也不做写入后的校验
        billRelMapper.insert(billId, contractId, period.getAmount());
    }
}

修复代码示例

class RentBillGenerator {
    @Transactional(rollbackFor = Exception.class)
    void generate(BillPeriod period, Long contractId) {
        // 补历史账期前先确认目标月份的临时表可写,不可写就直接失败,不留半条数据
        if (!tempTableMapper.exists(period.getMonth())) {
            throw new IllegalStateException("目标月份临时表不可用,账单未生成");
        }
        Long billId = billMapper.insert(period.toBill(contractId));
        // 账单与关系表同事务:审批读的是关系表,两者必须同时成功或同时失败
        billRelMapper.insert(billId, contractId, period.getAmount());
        // 临时表不参与审批展示,放在最后,失败时账单与关系记录已经一致
        tempTableMapper.insert(period.getMonth(), billId);
    }

    // 补数后按账单 id 反查,确认每笔都有关联,避免留下查不到的账单
    boolean visible(Long billId) {
        return billRelMapper.existsByBillId(billId);
    }
}

那笔账单已经人工补过关系记录,后台可以搜到;同一批补数的账单要按上面的方式逐笔反查一遍。

下次遇到这些场景要警惕

  • 手工补历史账期的账单、结算单:先确认目标月份的临时表或归档表还在、可写,再执行;拿一笔真实账期试跑,同时核对账单表、临时表、关系表三处都有记录。
  • 一条流程里按顺序写多张表:先列出页面、审批、报表分别读哪张表,把决定业务可见性的那张表和主记录放进同一个事务;不参与展示的表放在后面,它失败不能拖断关联。
  • 补数成功不等于业务可见:补完按业务入口实际搜一遍审批列表和账单列表,不要只看账单表有没有数据。
  • 补数工具要能返回每一步结果:临时表写失败时明确报错,并把已生成的账单标记为待补,避免留下一笔查不到的账单。