发生了什么
商户是和平台按账期结款的商家。平台每隔一段时间给商户生成结算单,一张结算单对应这期间应付给商户的一笔钱,金额、付款条件都在生成时写进这张单。
付款条件分两种。先款后票:平台先把钱打给商户,商户之后再补开发票。先票后款:商户先交发票,平台验票后再打款。付款条件按城市配置,一张单用哪一套,在生成时定下来。因为先款后票是先付钱、票后到,系统给这类单加了一道保护:结算单生成后超过 30 天仍没收到发票,就自动暂停这张单的结算,等发票补齐再放行。
正常的恢复流程是:商户把发票上传齐全后,一个后台任务扫出仍处于暂停状态的结算单,逐张放回结算,继续走到打款。暂停是按单发生的,恢复也按单判断——这张单当初按哪种付款条件被暂停,就按哪种条件恢复。
这次不同。5 月 22 日,某城市的付款条件从先款后票改成了先票后款。改动之前,这个城市已经生成了一批先款后票的结算单,其中 7 笔因超 30 天未开票被自动暂停。发票后来补齐了,这 7 笔却一直停在暂停状态,既没有恢复结算,也没有打款。反馈里一并列出了 14 笔未自动恢复的结算单,上面这 7 笔是切换规则前生成、属于本次确认机制的部分。
本质
结算单生成时,程序已经把当时的付款条件抄了一份存进单据自己的字段,这是一份快照。快照的含义很直接:这张单按什么规则结算,由生成那一刻决定,之后城市配置怎么改都不该影响它。
出问题的是那个恢复任务。它扫到一张暂停单时,第一件事不是看这张单自己的付款条件,而是去查这张单所属城市当前生效的规则:
- 任务查到城市当前规则是先票后款,直接返回,这张单这一轮就结束了。
- 任务查到城市当前规则是先款后票,才接着往下走,把单交给结算和打款步骤。
5 月 22 日之前生成的 7 笔单,快照上写的都是先款后票;但城市规则一改,任务查到的当前规则变成先票后款,第 1 步就把它们全部挡了回去。这些单除了这个恢复任务,没有别的路径会再来处理:暂停状态没人解锁,打款就一直不发生。切换前生成的老单,在配置变更那一刻集体变成了无人处理的存量。
关键不在漏了哪个判断,而在拿一个会变的全局配置去判断一件历史事实。付款条件在单据上已经有确定的、不可变的一份,任务却绕开它去问当前配置;只要配置再改一次,之前生成的所有同类单都会被重新判成不归它管。
恢复条件应该只由单据自己的快照决定;用当前配置当门槛,每次改配置都会把历史单据留在暂停里。
处理分两步。存量 7 笔走结算服务提供的补结算接口,按单号传进去:接口先过滤出仍处于待结算状态的单据,再发一条消息,由消息消费方重新生成可打款的单据并发起打款,这 7 笔已按此逐笔重新发起。任务侧改为按快照判断:过滤条件加上快照为先款后票的限制,并把读城市当前规则的那段提前返回移出恢复流程。这项改动是否已上线、上线后同类存量单是否全部恢复,记录里没有体现。
下面两段 Java 代码是按上述机制写的脱敏教学示例,只对比恢复条件该取哪份规则,不代表实际项目源码或已上线实现。
错误代码
// 开票补齐后恢复暂停的结算单(脱敏教学示例)
public class SettlementResumeJob {
private final BillRepository bills;
private final CityRuleService cityRule;
public void resume() {
List<Long> passed = new ArrayList<>();
for (Long id : bills.listByStatus(STATUS_PAUSED)) {
// 为什么错:闸门读城市“当前”生效的付款条件,不是单据生成时的快照
if (PAY_AFTER_INVOICE.equals(cityRule.currentPayCondition(bills.get(id).getCityCode()))) {
continue; // 城市已切成先票后款,切换前生成的先款后票单在这里被挡掉
}
passed.add(id);
}
filterUnsettled(passed).forEach(this::settle);
}
List<Long> filterUnsettled(List<Long> billIds) {
return billIds.stream()
// 为什么错:只按状态过滤,快照里记的先款后票还是先票后款不参与判断
.filter(id -> STATUS_PAUSED.equals(bills.get(id).getStatus()))
.collect(Collectors.toList());
}
}
修复代码示例
// 同一段恢复逻辑:判断条件回到单据自身的快照(脱敏教学示例)
public class SettlementResumeJob {
private final BillRepository bills;
public void resume() {
// 修复:去掉读城市当前规则的闸门,哪些单可恢复由单据快照和状态决定
filterUnsettled(bills.listByStatus(STATUS_PAUSED)).forEach(this::settle);
}
List<Long> filterUnsettled(List<Long> billIds) {
return billIds.stream()
.filter(id -> STATUS_PAUSED.equals(bills.get(id).getStatus()))
// 修复:只恢复快照为先款后票的单据(示例取值,示意)
.filter(id -> bills.get(id).getInvoiceType() == INVOICE_BEFORE_PAY)
.collect(Collectors.toList());
}
}
下次遇到这些场景要警惕
- 单据里已经存了规则快照时:恢复、补发、对账的定时任务上线前,确认判断条件取自单据字段还是取自当前配置;取配置的,把配置改一次再跑任务,看历史单据是否还在处理范围内。
- 要改全局配置(付款条件、费率、账期一类)时:先算清存量影响——用新配置跑一遍恢复任务,统计被跳过的单据数量,再和库里“暂停且发票已补齐”的单量对比,差额就是要人工补的。
- 恢复任务里出现 return 或 continue 的跳过分支时:给每个分支加计数和告警,把跳过的单量、最长暂停时长做成指标;静默跳过正是这类问题能潜伏数月的直接原因。
- 处置存量单据时:先用补结算接口按单号小批量试跑,核对接口过滤出的待结算单数与传参一致、打款结果可查,再放全量;不能只改任务代码就当存量已经解决。