架构与系统设计 / 系统课时
结算批次生成
结算批次生成
本课完成一条可落地的结算批次生成链路:从待结算明细中按商户、币种和结算日期分组,计算应结金额,写入批次并绑定明细,同时用唯一约束和事务避免重复生成。
学习目标
- 明确结算批次的分组键与金额口径
- 使用 SQL 汇总明细并生成可追溯批次
- 处理重复执行、迟到退款和异常金额等边界
批次边界与金额口径
一个结算批次只应覆盖同一商户、同一币种和同一结算日期的数据。推荐使用 merchant_no + currency + settlement_date 作为业务唯一键,避免不同币种混算,也避免同一天重复生成多个正式批次。
批次应结金额通常按“支付金额减退款、减手续费、加调整项”计算。调整项用于承接补差、冲正或上一周期遗留,不应直接修改已经确认的历史明细。

批次编号只负责标识,不应承担幂等判断。真正的幂等保障应来自业务唯一键和数据库唯一索引,任务锁只能减少并发,不能替代数据库约束。
使用 SQL 生成批次
下面示例可直接在 MySQL 8.0 执行。它先准备批次表和明细表,再汇总 READY 明细,最后把明细绑定到对应批次。
sql
DROP TABLE IF EXISTS settlement_detail;
DROP TABLE IF EXISTS settlement_batch;
CREATE TABLE settlement_batch (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
batch_no VARCHAR(64) NOT NULL,
merchant_no VARCHAR(32) NOT NULL,
currency CHAR(3) NOT NULL,
settlement_date DATE NOT NULL,
gross_amount DECIMAL(18, 2) NOT NULL,
refund_amount DECIMAL(18, 2) NOT NULL,
fee_amount DECIMAL(18, 2) NOT NULL,
adjustment_amount DECIMAL(18, 2) NOT NULL,
settlement_amount DECIMAL(18, 2) NOT NULL,
detail_count INT NOT NULL,
status VARCHAR(16) NOT NULL DEFAULT 'CREATED',
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
ON UPDATE CURRENT_TIMESTAMP,
-- 业务唯一键是最终幂等防线
UNIQUE KEY uk_batch_scope (merchant_no, currency, settlement_date),
UNIQUE KEY uk_batch_no (batch_no)
);
CREATE TABLE settlement_detail (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
merchant_no VARCHAR(32) NOT NULL,
currency CHAR(3) NOT NULL,
settlement_date DATE NOT NULL,
pay_amount DECIMAL(18, 2) NOT NULL,
refund_amount DECIMAL(18, 2) NOT NULL,
fee_amount DECIMAL(18, 2) NOT NULL,
adjustment_amount DECIMAL(18, 2) NOT NULL DEFAULT 0,
status VARCHAR(16) NOT NULL DEFAULT 'READY',
batch_no VARCHAR(64) NULL
);
-- 准备两组商户的待结算明细
INSERT INTO settlement_detail
(merchant_no, currency, settlement_date, pay_amount, refund_amount, fee_amount)
VALUES
('M1001', 'HKD', '2026-08-03', 100.00, 0.00, 2.00),
('M1001', 'HKD', '2026-08-03', 200.00, 10.00, 4.00),
('M2001', 'HKD', '2026-08-03', 80.00, 0.00, 1.60);
-- 批次与明细绑定必须处于同一事务
START TRANSACTION;
INSERT INTO settlement_batch (
batch_no, merchant_no, currency, settlement_date,
gross_amount, refund_amount, fee_amount,
adjustment_amount, settlement_amount, detail_count
)
SELECT
-- 示例使用可读编号;生产环境也可改为号段生成器
CONCAT(
'SB', DATE_FORMAT(settlement_date, '%Y%m%d'),
'-', merchant_no, '-', currency
),
merchant_no,
currency,
settlement_date,
SUM(pay_amount),
SUM(refund_amount),
SUM(fee_amount),
SUM(adjustment_amount),
SUM(pay_amount - refund_amount - fee_amount + adjustment_amount),
COUNT(*)
FROM settlement_detail
WHERE settlement_date = '2026-08-03'
AND status = 'READY'
GROUP BY merchant_no, currency, settlement_date;
UPDATE settlement_detail d
JOIN settlement_batch b
ON b.merchant_no = d.merchant_no
AND b.currency = d.currency
AND b.settlement_date = d.settlement_date
SET d.batch_no = b.batch_no,
d.status = 'BATCHED'
WHERE d.settlement_date = '2026-08-03'
AND d.status = 'READY';
COMMIT;
SELECT batch_no, merchant_no, currency,
settlement_amount, detail_count
FROM settlement_batch
ORDER BY merchant_no;预期结果:
text
batch_no merchant_no currency settlement_amount detail_count
SB20260803-M1001-HKD M1001 HKD 284.00 2
SB20260803-M2001-HKD M2001 HKD 78.40 1再次执行同一段生成逻辑时,唯一索引会阻止重复批次,已变为 BATCHED 的明细也不会再次汇总。实际环境中的日期、批次号和主键会不同。
并发与异常边界
生产任务开始前可以按结算日期申请分布式锁,但数据库仍需保留唯一索引。并发节点同时执行时,应先通过条件更新把明细从 READY 抢占为 PROCESSING,再汇总本节点成功抢占的数据,避免一个明细被两个节点读取。
应结金额为零时可以生成零金额批次,也可以按业务规则跳过;应结金额为负数时通常进入人工审核。结算日之后才到达的退款,不应回写已确认批次,而应在下一批次中生成负向明细或调整项。
批次确认前要校验明细数量、金额合计和币种一致性。确认后禁止直接删除或重算,应通过冲正批次保留审计链路。
按自己的节奏,确认真正理解。