架构与系统设计 / 系统课时
差错处理流程
差错处理流程
对账发现差异后,系统不能直接修改订单状态或账务数据,而应先确认事实、完成复核,再执行受控修正。本课将设计一套包含差错登记、人工复核、状态迁移、修正执行和审计留痕的闭环流程。
学习目标
- 划分差错处理中的状态、角色和操作边界
- 使用受控状态迁移避免重复或越权修正
- 设计可审计的修正记录与验收方法
建立差错处理状态
差错记录建议从 PENDING_CONFIRM 开始,表示系统已发现差异但尚未确认。经办人核对平台订单、渠道账单和原始凭证后,可提交到 UNDER_REVIEW,由另一名复核人判断是否需要修正。
复核通过后进入 CORRECTING,系统执行订单状态、账务流水或补单操作。修正成功后进入 RESOLVED;若确认是渠道账单延迟、重复文件或无需处理的误报,则进入 REJECTED。已结束状态不得直接回退,确需重开时应创建新的处理单并关联原记录。

状态机的价值是限制“谁能在什么条件下做什么”。例如,经办人不能复核自己的处理单,复核通过前不能执行账务修正,修正接口重复调用时必须通过幂等键返回已有结果。
记录处理事实而不是覆盖历史
差错主表保存当前状态、差错类型、平台金额、渠道金额、负责人和版本号;操作日志表追加保存每一次动作。不要只在主表中覆盖备注和处理人,否则无法还原谁在何时基于什么证据做出决定。
对于涉及资金的修正,日志至少要记录处理单号、动作、修正前状态、修正后状态、操作者、原因和业务请求号。敏感凭证可保存对象存储地址或摘要,不应把完整银行卡号、密钥或原始报文直接写入日志。
用事务和乐观锁完成状态修正
下面示例可在 MySQL 8.0 中直接执行。它创建差错主表和操作日志表,再模拟复核通过。version_no 用于防止两名复核人同时提交导致状态被重复覆盖。
CREATE TEMPORARY TABLE reconciliation_error (
id BIGINT PRIMARY KEY,
error_no VARCHAR(32) NOT NULL UNIQUE,
error_type VARCHAR(32) NOT NULL,
status VARCHAR(32) NOT NULL,
handler VARCHAR(64),
version_no INT NOT NULL DEFAULT 0
);
CREATE TEMPORARY TABLE reconciliation_error_log (
id BIGINT AUTO_INCREMENT PRIMARY KEY,
error_no VARCHAR(32) NOT NULL,
action_name VARCHAR(32) NOT NULL,
before_status VARCHAR(32) NOT NULL,
after_status VARCHAR(32) NOT NULL,
operator_name VARCHAR(64) NOT NULL,
reason_text VARCHAR(255) NOT NULL
);
INSERT INTO reconciliation_error
(id, error_no, error_type, status, handler, version_no)
VALUES
(1, 'E202608030001', 'AMOUNT_MISMATCH', 'UNDER_REVIEW', 'reviewer_b', 0);
START TRANSACTION;
UPDATE reconciliation_error
SET status = 'CORRECTING',
version_no = version_no + 1
WHERE error_no = 'E202608030001'
AND status = 'UNDER_REVIEW'
AND version_no = 0;
INSERT INTO reconciliation_error_log
(error_no, action_name, before_status, after_status, operator_name, reason_text)
SELECT
'E202608030001',
'APPROVE',
'UNDER_REVIEW',
'CORRECTING',
'reviewer_b',
'渠道账单已核验,批准进入修正'
WHERE ROW_COUNT() = 1;
COMMIT;
SELECT error_no, status, version_no
FROM reconciliation_error
WHERE error_no = 'E202608030001';
SELECT error_no, action_name, before_status, after_status, operator_name
FROM reconciliation_error_log
WHERE error_no = 'E202608030001';预期结果如下。若并发请求已先更新版本号,第一条 UPDATE 影响行数会变为 0,日志也不会插入,调用方应提示“状态已变化,请刷新后重试”。
error_no | status | version_no
E202608030001 | CORRECTING | 1
error_no | action_name | before_status | after_status | operator_name
E202608030001 | APPROVE | UNDER_REVIEW | CORRECTING | reviewer_b实际系统中,应在事务提交后再触发异步修正任务。修正任务使用 error_no 或独立请求号作为幂等键,并把执行结果回写为 RESOLVED 或保留在 CORRECTING 等待重试。
控制人工复核与自动修正
人工复核页面应同时展示平台原始记录、渠道原始记录、匹配规则和差异字段,避免复核人只看结论。涉及金额、账户余额或清算状态的修正应采用经办与复核分离,且复核人不能与经办人相同。
自动修正只适用于规则明确、可幂等、可回滚的场景,例如补写遗漏的渠道流水号。需要补记账务流水、调整余额或处理未知渠道状态时,应保留人工审批,并在执行前再次读取最新订单状态,防止使用过期结论。
验证处理闭环
验收时先检查状态迁移是否符合规则,再确认主表状态与日志最后一条记录一致。随后验证同一个处理单重复提交不会重复记账,失败任务能够安全重试,终态记录不能被普通操作直接修改。
还应按批次统计待确认、复核中、修正中和已结束数量。若 CORRECTING 长时间不收敛,系统需要告警并提供失败原因,而不是让处理单永久停留在处理中。