架构与系统设计 / 系统课时
账务流水设计
账务流水设计
本课完成一套可落地的账务流水模型:把支付、退款、手续费和调账统一记录为不可修改的借贷分录,并通过业务单号、凭证号与账户余额建立可追溯关系。
学习目标
- 理解不可变流水、凭证与分录之间的职责边界
- 设计支持支付、退款、手续费和调账的核心表结构
- 掌握流水入账、冲正和幂等控制的关键规则
从资金变化拆分账务对象
业务订单描述“发生了什么”,账务凭证描述“为什么记账”,账务分录描述“哪些账户发生了多少变化”。三者不能合并成一张表,否则退款、部分退款和调账会不断覆盖原始数据,最终失去审计依据。
一笔业务事件通常生成一张凭证,一张凭证包含两条或更多分录。每条分录只表达某个账户的一次借方或贷方变化,已入账分录禁止更新金额、方向和账户;发现错误时,应追加冲正凭证,而不是修改旧流水。

建立凭证、分录与余额账户
核心模型可拆为账户表、凭证表和分录表。账户表保存当前余额,凭证表承载业务幂等键,分录表保存不可变明细。下面示例采用“借方减少、贷方增加”的简化账户规则,生产系统还应明确不同账户类型的余额方向。
CREATE TABLE account_balance (
account_no VARCHAR(64) PRIMARY KEY,
account_type VARCHAR(32) NOT NULL,
balance BIGINT NOT NULL DEFAULT 0,
version BIGINT NOT NULL DEFAULT 0,
updated_at DATETIME(3) NOT NULL
);
CREATE TABLE ledger_voucher (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
voucher_no VARCHAR(64) NOT NULL,
biz_type VARCHAR(32) NOT NULL,
biz_order_no VARCHAR(64) NOT NULL,
request_id VARCHAR(64) NOT NULL,
status VARCHAR(16) NOT NULL,
created_at DATETIME(3) NOT NULL,
UNIQUE KEY uk_voucher_no (voucher_no),
UNIQUE KEY uk_biz_request (biz_type, biz_order_no, request_id)
);
CREATE TABLE ledger_entry (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
voucher_id BIGINT NOT NULL,
account_no VARCHAR(64) NOT NULL,
direction VARCHAR(8) NOT NULL,
amount BIGINT NOT NULL,
currency CHAR(3) NOT NULL,
created_at DATETIME(3) NOT NULL,
CHECK (direction IN ('DEBIT', 'CREDIT')),
CHECK (amount > 0),
KEY idx_entry_account_time (account_no, created_at),
KEY idx_entry_voucher (voucher_id)
);
INSERT INTO ledger_voucher
(voucher_no, biz_type, biz_order_no, request_id, status, created_at)
VALUES
('V202608030001', 'PAYMENT', 'P202608030001', 'REQ-001', 'POSTED', NOW(3));
SET @voucher_id = LAST_INSERT_ID();
INSERT INTO ledger_entry
(voucher_id, account_no, direction, amount, currency, created_at)
VALUES
(@voucher_id, 'PLATFORM_CLEARING', 'DEBIT', 10000, 'CNY', NOW(3)),
(@voucher_id, 'MERCHANT_1001', 'CREDIT', 10000, 'CNY', NOW(3));预期结果
ledger_voucher 新增 1 行
ledger_entry 新增 2 行
同一凭证借方合计 10000,贷方合计 10000金额应使用最小货币单位,例如人民币 100.00 元保存为 10000 分,避免浮点误差。uk_biz_request 用于阻止同一业务请求重复入账,idx_entry_account_time 用于按账户和时间范围查询明细。
统一表达四类资金事件
支付成功通常增加商户待结算余额;退款成功减少商户余额或形成应收;手续费可在支付时同步扣除,也可独立生成手续费凭证;人工调账必须保存原因、操作人和审批记录。
| 事件 | 典型分录 | 是否修改原流水 |
|---|---|---|
| 支付成功 | 平台清算账户借记,商户账户贷记 | 否 |
| 退款成功 | 商户账户借记,平台清算账户贷记 | 否 |
| 手续费 | 商户账户借记,手续费收入账户贷记 | 否 |
| 调账或冲正 | 按原分录反向记账,再记录正确分录 | 否 |
部分退款必须生成独立退款凭证,并关联原支付订单。多次部分退款的累计金额不得超过原支付金额,但每次退款仍保留独立的业务单号和账务凭证。
保证入账原子性与不可变性
创建凭证、插入分录和更新余额必须位于同一数据库事务中。入账前先校验借贷合计相等,再按固定账户顺序加锁并更新余额,避免并发交易产生死锁或余额覆盖。
不可变并不代表数据库绝对禁止任何更新。凭证可以从 INIT 更新为 POSTED 或 FAILED,但已经入账的分录金额、方向、币种和账户不得修改或删除。生产环境可通过权限隔离、审计日志和数据库触发器进一步限制直接变更。
调账也要遵守幂等规则。重复提交相同 request_id 时,应返回已存在的凭证结果,而不是再次生成分录。这样即使消息重复投递或接口超时重试,账务余额也只变化一次。
验收检查
完成设计后,应至少验证以下结果:
- 每张已入账凭证的借方总额等于贷方总额
- 同一业务请求无法生成第二张凭证
- 任意退款和调账都能追溯到原业务订单或原凭证
- 删除或修改已入账分录的操作被应用层和数据库权限共同阻止