发生了什么
平台结算做的事,是把商户在平台上经营产生的租金和电费,一笔一笔变成可打款的钱。每一笔待结算的钱在系统里是一条账单,账单上标明这笔钱属于哪一类收入子类,这批账单里出现的就是租金和电费两类。账单先进入待处理池,等结算程序处理:程序为账单生成一个付款单号,再凭这个付款单号把钱打款到商户在第三方的账户。付款单号是打款的前置条件,账单没有付款单号,钱就一直不会到账。
正常流程是:待处理池里的账单由结算消息消费,租金和电费是两条相互独立的消息,各自只处理自己那一类账单。结算程序每一轮从池子里取出标识最小的一页(一页 200 条),把属于本类的账单处理掉;处理过的账单从池子里消失,下一轮自然前移,直到取不到账单为止。
2026 年 7 月 4 日这一批不一样:待处理池里租金和电费账单混在一起,而且总量超过了一页。当天有商户反馈,账单审批通过后,款项一直没有生成付款单号,也没有充值到第三方账户。
本质
问题出在取数范围、处理范围和退出条件这三处对不上。
- 取数不区分类型。查询待处理账单的 SQL 只有状态条件,没有收入子类条件,按标识升序返回 200 条,这 200 条里可能既有电费也有租金。
- 处理只认一类。消息带着自己的收入子类进来,程序在内存里把不属于这一类的记录过滤掉,只处理剩下的。
- 程序不翻页。它每一轮都重新取"标识最小的 200 条",靠处理过的账单从池子里消失来往前挪,本身没有"下一页"这个动作。一旦取到的 200 条全是另一类,它就没有办法越过这一批。
- 空页被当成结束。内存过滤之后结果为空时,程序直接返回,结束本次消费——把"这一页里没有我的账单"当成了"没有待处理的账单"。
那一批账单的标识顺序是电费①、租金②、电费③。电费消息进来,处理完电费①,下一轮取到租金②整页,过滤后为空,直接结束;排在租金②后面的电费③共 37 条没有被处理。租金消息进来,标识最小的一批就是电费①,过滤后为空,0.09 秒就结束,租金②共 222 条全部漏掉。
取到空的一页不代表没有待处理,程序却把它当成了结束条件。
漏哪一类并不固定,取决于标识最小的那批恰好属于哪一类。只要两类账单混排、总量超过一页,就必然有一批账单排在另一类后面,当前消息永远取不到它们,这批账单也就一直停在待结算状态,既没有付款单号,也没有打款。
存量处理是按"先清标识较小的那一类、再清另一类"的顺序重放消息,把漏掉的账单补生成付款单并发起打款。根因修复方向是把收入子类下推到查询条件,让查询只返回当前这一类,并去掉之后的内存过滤;修复随之后的技改一起发布,上线状态待确认。
错误代码
// 每轮只取"标识最小"的一页,查询条件里没有收入子类
PageCondition condition = new PageCondition();
condition.setStatus(PENDING);
while (true) {
List<PlatformBill> page = billMapper.pageQueryPendingPlatformBillMerchantList(
condition, 1, PAGE_SIZE); // 永远取第一页,靠处理过的数据消失往前挪
if (page.isEmpty()) {
return; // 池子真空,正常结束
}
List<PlatformBill> mine = page.stream()
.filter(b -> subCategory.equals(b.getIncomeSubCategory()))
.collect(Collectors.toList());
if (mine.isEmpty()) {
// 为什么错:整页都是另一类账单时直接结束消费,
// 排在后面的本类账单再也取不到,也没有下一次机会
return;
}
mine.forEach(this::pinchAndPay); // 生成付款单号并发起打款
}
PlatformBill 是一条待结算账单,incomeSubCategory 是它所属的收入子类,pageQueryPendingPlatformBillMerchantList 是按状态和分页参数取待处理账单的查询,pinchAndPay 把一条账单生成付款单号并拉起打款。PAGE_SIZE 为 200,来自记录中的分页上限。
修复代码示例
// 修复:把收入子类下推到查询条件,查询只返回本类账单
PageCondition condition = new PageCondition();
condition.setStatus(PENDING);
condition.setSubIncomeCategory(subCategory); // 新增子类条件
// 对应 SQL 增加:and income_sub_category = #{subIncomeCategory}
while (true) {
List<PlatformBill> page = billMapper.pageQueryPendingPlatformBillMerchantList(
condition, 1, PAGE_SIZE);
if (page.isEmpty()) {
return; // 只在本类账单确实为空时结束
}
page.forEach(this::pinchAndPay); // 查询已精确,不再内存过滤
}
查询条件加上子类之后,取数范围和处理范围就一致了,"整页都是另一类"这种状态不会出现,空页只可能意味着本类真的处理完了。存量账单仍需按上面的顺序重放消息补齐,这部分不能靠改代码自动完成。
下次遇到这些场景要警惕
- 多类数据共用一张待处理表、由不同消息分别消费:先看查询 SQL 的 where 里有没有该类的过滤条件;再构造"整页都是另一类"的数据跑一次消费,观察程序是继续向后取,还是直接结束。
- 批处理靠"处理后从池子里消失"推进、不显式翻页:造一个超过单页上限、两类数据交替的批次,检查排在另一类后面的记录是否都被处理,而不是只看第一页里的记录。
- 消费方法里有表示"没数据了"的返回:逐一核对它只能在查询结果确实为空时触发;过滤后为空属于"本页没有我的数据",必须继续向后取。
- 修复上线前按历史最大批量核对一次:处理前后的待处理数量与生成的付款单笔数是否对得上,避免只验证了单页内的排序。
代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。