架构与系统设计 / 系统课时

余额一致性校验

余额一致性校验

本课实现一套三方核对方法:同时比较账户当前余额、账务流水累计值和业务订单应记金额,快速识别漏记、重复记账、状态错配及余额被异常修改的问题。

学习目标

  • 建立账户余额、账务流水和业务订单的三方校验关系
  • 编写可定位差异账户与差异订单的核对 SQL
  • 设计日常校验、差异分级和修复后的复核流程

明确三类数据的校验关系

账户余额是系统当前可用结果,账务流水是每次资金变化的事实记录,业务订单是触发记账的业务依据。三者分别回答“现在有多少”“如何变化到现在”“为什么发生变化”。

校验不能只比较订单总额与余额,因为退款、手续费、冻结、解冻和调账都会改变账户。可靠做法是先验证账户余额是否等于期初余额加流水净额,再验证每个应入账业务事件是否存在唯一、金额正确的凭证。

余额、流水与业务订单三方一致性校验流程

先核对余额与流水净额

对某个校验日,先取得日初余额,再汇总当天已入账分录。采用“贷方增加、借方减少”的账户规则时,理论期末余额为:

期末理论余额=期初余额+贷方发生额−借方发生额期末理论余额 = 期初余额 + 贷方发生额 - 借方发生额

下面 SQL 按账户计算理论余额,并筛出与实际余额不一致的账户。示例假设 account_daily_snapshot 保存日初快照,account_balance 保存当前余额,ledger_entry 仅统计已入账凭证。

sql
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;

预期结果

text
无差异时返回 0 行。
存在差异时,每行给出 account_no、expected_balance 和 actual_balance,可直接计算差额。

时间范围必须使用左闭右开区间,不要对 created_at 使用 DATE() 等函数,否则可能导致索引失效。核对历史日期时,实际余额应来自对应日终快照,不能直接拿今天的实时余额比较。

再核对订单与账务凭证

余额相等并不代表每笔业务都正确。例如一笔支付漏记、另一笔支付重复记账且金额相同,账户总额仍可能碰巧平衡。因此还要按业务单号检查应入账订单是否有且仅有一张已入账凭证。

sql
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;

预期结果

text
无差异时返回 0 行。
voucher_count = 0 表示漏记,voucher_count > 1 表示重复记账,posted_amount 不等于 order_amount 表示金额不一致。

这条查询是核对主路径的片段示例,依赖 business_order、ledger_voucher 和 ledger_entry 已按前述字段建表。若支付手续费采用独立凭证,应只比较商户本金分录,手续费另按费用规则核对。

按定位顺序处理差异

出现差异时,不要直接修改余额。应先判断差异属于哪一层,再选择修复方式:

  1. 订单成功但无凭证:检查记账消息是否丢失、消费是否失败,再使用原业务幂等键补记。
  2. 一笔订单对应多张凭证:检查幂等约束和并发重试,确认重复凭证后生成冲正凭证。
  3. 凭证正确但余额错误:检查余额更新事务、并发锁和人工数据库操作,使用调账凭证修正。
  4. 订单金额与分录金额不同:核对币种、最小货币单位、手续费拆分和部分退款规则。

差异记录应保存校验批次、账户号、业务单号、理论值、实际值、差额、严重级别和处理状态。修复动作也必须有审批与审计轨迹,不能只在工单中写一句“已处理”。

建立可重复执行的校验任务

日常任务可以分为日终全量校验和小时级增量校验。日终任务覆盖所有账户并生成正式报告;增量任务只扫描最近完成的订单和最近变化的账户,用于尽早发现问题。

校验任务本身必须可重跑。同一校验日期和校验类型应具有唯一批次键,重复执行时覆盖未确认的临时结果或生成新版本,但不能重复触发调账。校验查询只读,修复动作必须由独立流程执行。

建议把差异按影响分级:余额差异和重复记账属于高优先级,单笔凭证延迟可在确认消息仍在重试后标为中优先级,字段展示差异则可单独归入低优先级。告警内容应包含账户、订单、差额和首次发现时间。

验证修复是否真正完成

修复后必须重新执行原批次的两类查询,并确认差异行消失。同时检查新增的是补记、冲正或调账凭证,而不是原流水被修改。

最终验收包括三项:账户理论余额等于实际余额;每个成功业务订单对应唯一正确凭证;修复前后的差异记录和审批记录可以完整追溯。只有三项同时通过,差异才能关闭。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

余额一致性校验

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通