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

差错处理流程

差错处理流程

对账发现差异后,系统不能直接修改订单状态或账务数据,而应先确认事实、完成复核,再执行受控修正。本课将设计一套包含差错登记、人工复核、状态迁移、修正执行和审计留痕的闭环流程。

学习目标

  • 划分差错处理中的状态、角色和操作边界
  • 使用受控状态迁移避免重复或越权修正
  • 设计可审计的修正记录与验收方法

建立差错处理状态

差错记录建议从 PENDING_CONFIRM 开始,表示系统已发现差异但尚未确认。经办人核对平台订单、渠道账单和原始凭证后,可提交到 UNDER_REVIEW,由另一名复核人判断是否需要修正。

复核通过后进入 CORRECTING,系统执行订单状态、账务流水或补单操作。修正成功后进入 RESOLVED;若确认是渠道账单延迟、重复文件或无需处理的误报,则进入 REJECTED。已结束状态不得直接回退,确需重开时应创建新的处理单并关联原记录。

差错处理状态与角色流转图

状态机的价值是限制“谁能在什么条件下做什么”。例如,经办人不能复核自己的处理单,复核通过前不能执行账务修正,修正接口重复调用时必须通过幂等键返回已有结果。

记录处理事实而不是覆盖历史

差错主表保存当前状态、差错类型、平台金额、渠道金额、负责人和版本号;操作日志表追加保存每一次动作。不要只在主表中覆盖备注和处理人,否则无法还原谁在何时基于什么证据做出决定。

对于涉及资金的修正,日志至少要记录处理单号、动作、修正前状态、修正后状态、操作者、原因和业务请求号。敏感凭证可保存对象存储地址或摘要,不应把完整银行卡号、密钥或原始报文直接写入日志。

用事务和乐观锁完成状态修正

下面示例可在 MySQL 8.0 中直接执行。它创建差错主表和操作日志表,再模拟复核通过。version_no 用于防止两名复核人同时提交导致状态被重复覆盖。

sql
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,日志也不会插入,调用方应提示“状态已变化,请刷新后重试”。

text
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 长时间不收敛,系统需要告警并提供失败原因,而不是让处理单永久停留在处理中。

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

目录与阅读设置

阅读设置

17

记录一个想法

差错处理流程

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

登录哪都通