架构与系统设计 / 系统课时
余额一致性校验
余额一致性校验
本课实现一套三方核对方法:同时比较账户当前余额、账务流水累计值和业务订单应记金额,快速识别漏记、重复记账、状态错配及余额被异常修改的问题。
学习目标
- 建立账户余额、账务流水和业务订单的三方校验关系
- 编写可定位差异账户与差异订单的核对 SQL
- 设计日常校验、差异分级和修复后的复核流程
明确三类数据的校验关系
账户余额是系统当前可用结果,账务流水是每次资金变化的事实记录,业务订单是触发记账的业务依据。三者分别回答“现在有多少”“如何变化到现在”“为什么发生变化”。
校验不能只比较订单总额与余额,因为退款、手续费、冻结、解冻和调账都会改变账户。可靠做法是先验证账户余额是否等于期初余额加流水净额,再验证每个应入账业务事件是否存在唯一、金额正确的凭证。

先核对余额与流水净额
对某个校验日,先取得日初余额,再汇总当天已入账分录。采用“贷方增加、借方减少”的账户规则时,理论期末余额为:
下面 SQL 按账户计算理论余额,并筛出与实际余额不一致的账户。示例假设 account_daily_snapshot 保存日初快照,account_balance 保存当前余额,ledger_entry 仅统计已入账凭证。
SELECT
s.account_no,
s.closing_balance AS opening_balance,
COALESCE(SUM(CASE WHEN e.direction = 'CREDIT' THEN e.amount ELSE 0 END), 0) AS credit_amount,
COALESCE(SUM(CASE WHEN e.direction = 'DEBIT' THEN e.amount ELSE 0 END), 0) AS debit_amount,
s.closing_balance
+ COALESCE(SUM(CASE WHEN e.direction = 'CREDIT' THEN e.amount ELSE 0 END), 0)
- COALESCE(SUM(CASE WHEN e.direction = 'DEBIT' THEN e.amount ELSE 0 END), 0) AS expected_balance,
b.balance AS actual_balance
FROM account_daily_snapshot s
JOIN account_balance b
ON b.account_no = s.account_no
LEFT JOIN ledger_entry e
ON e.account_no = s.account_no
AND e.created_at >= '2026-08-03 00:00:00'
AND e.created_at < '2026-08-04 00:00:00'
WHERE s.snapshot_date = '2026-08-02'
GROUP BY s.account_no, s.closing_balance, b.balance
HAVING expected_balance <> actual_balance;预期结果
无差异时返回 0 行。
存在差异时,每行给出 account_no、expected_balance 和 actual_balance,可直接计算差额。时间范围必须使用左闭右开区间,不要对 created_at 使用 DATE() 等函数,否则可能导致索引失效。核对历史日期时,实际余额应来自对应日终快照,不能直接拿今天的实时余额比较。
再核对订单与账务凭证
余额相等并不代表每笔业务都正确。例如一笔支付漏记、另一笔支付重复记账且金额相同,账户总额仍可能碰巧平衡。因此还要按业务单号检查应入账订单是否有且仅有一张已入账凭证。
SELECT
o.order_no,
o.order_type,
o.amount AS order_amount,
COUNT(v.id) AS voucher_count,
COALESCE(SUM(
CASE
WHEN e.account_no = o.merchant_account_no
AND e.direction = CASE WHEN o.order_type = 'PAYMENT' THEN 'CREDIT' ELSE 'DEBIT' END
THEN e.amount
ELSE 0
END
), 0) AS posted_amount
FROM business_order o
LEFT JOIN ledger_voucher v
ON v.biz_order_no = o.order_no
AND v.biz_type = o.order_type
AND v.status = 'POSTED'
LEFT JOIN ledger_entry e
ON e.voucher_id = v.id
WHERE o.status = 'SUCCESS'
AND o.completed_at >= '2026-08-03 00:00:00'
AND o.completed_at < '2026-08-04 00:00:00'
GROUP BY o.order_no, o.order_type, o.amount
HAVING voucher_count <> 1 OR posted_amount <> order_amount;预期结果
无差异时返回 0 行。
voucher_count = 0 表示漏记,voucher_count > 1 表示重复记账,posted_amount 不等于 order_amount 表示金额不一致。这条查询是核对主路径的片段示例,依赖 business_order、ledger_voucher 和 ledger_entry 已按前述字段建表。若支付手续费采用独立凭证,应只比较商户本金分录,手续费另按费用规则核对。
按定位顺序处理差异
出现差异时,不要直接修改余额。应先判断差异属于哪一层,再选择修复方式:
- 订单成功但无凭证:检查记账消息是否丢失、消费是否失败,再使用原业务幂等键补记。
- 一笔订单对应多张凭证:检查幂等约束和并发重试,确认重复凭证后生成冲正凭证。
- 凭证正确但余额错误:检查余额更新事务、并发锁和人工数据库操作,使用调账凭证修正。
- 订单金额与分录金额不同:核对币种、最小货币单位、手续费拆分和部分退款规则。
差异记录应保存校验批次、账户号、业务单号、理论值、实际值、差额、严重级别和处理状态。修复动作也必须有审批与审计轨迹,不能只在工单中写一句“已处理”。
建立可重复执行的校验任务
日常任务可以分为日终全量校验和小时级增量校验。日终任务覆盖所有账户并生成正式报告;增量任务只扫描最近完成的订单和最近变化的账户,用于尽早发现问题。
校验任务本身必须可重跑。同一校验日期和校验类型应具有唯一批次键,重复执行时覆盖未确认的临时结果或生成新版本,但不能重复触发调账。校验查询只读,修复动作必须由独立流程执行。
建议把差异按影响分级:余额差异和重复记账属于高优先级,单笔凭证延迟可在确认消息仍在重试后标为中优先级,字段展示差异则可单独归入低优先级。告警内容应包含账户、订单、差额和首次发现时间。
验证修复是否真正完成
修复后必须重新执行原批次的两类查询,并确认差异行消失。同时检查新增的是补记、冲正或调账凭证,而不是原流水被修改。
最终验收包括三项:账户理论余额等于实际余额;每个成功业务订单对应唯一正确凭证;修复前后的差异记录和审批记录可以完整追溯。只有三项同时通过,差异才能关闭。