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

冻结与解冻

冻结与解冻

本课实现一套可落地的资金冻结机制:在不改变账户总额的前提下,将可用余额转入冻结余额,并通过幂等流水完成风险解除、保证金释放和到期自动解冻。

学习目标

  • 理解总余额、可用余额和冻结余额之间的不变量
  • 使用唯一请求号和事务实现幂等冻结、幂等解冻
  • 设计到期扫描与异常补偿,避免资金被重复释放

资金冻结的账务本质

冻结不是扣款,也不是产生一笔新的资金。它只是在同一账户内部移动余额。若金额统一使用最小货币单位,例如人民币分,则任意时刻都应满足:

总余额=可用余额+冻结余额总余额 = 可用余额 + 冻结余额

冻结金额为 xx 时,可用余额减少 xx,冻结余额增加 xx;解冻时执行完全相反的变更。风险冻结、保证金冻结和人工冻结可以共用同一套账户动作,差异放在冻结类型、到期时间和解冻条件中表达。

冻结记录必须独立于账户表保存。账户表回答“现在有多少钱”,冻结记录回答“为什么被冻结、由哪个请求触发、何时可以释放”。若只修改账户余额而不记录业务流水,后续无法审计,也无法可靠地重试。

状态与执行流程

一笔冻结记录可以使用 INIT、FROZEN、RELEASED 三个核心状态。创建请求后先锁定冻结记录,再锁定账户并转移余额;解冻时只允许 FROZEN 转为 RELEASED。相同请求重复到达时,直接返回已有结果,不再次变更余额。

冻结与解冻状态及余额流向

真正需要防止的不是“接口被调用两次”,而是“同一业务意图导致余额变更两次”。因此,幂等键应由调用方生成并落到唯一索引,例如 freeze_request_no。解冻也应使用独立的 release_request_no,并与原冻结记录关联。

可执行的数据库示例

下面脚本可在 MySQL 8.0 的空数据库中执行。示例金额均为分,先冻结 30000 分,再释放同一笔冻结。存储过程通过行锁、唯一请求号和异常回滚保证单次执行的一致性。

sql
CREATE TABLE merchant_account (
    account_id BIGINT PRIMARY KEY,
    total_balance BIGINT NOT NULL,
    available_balance BIGINT NOT NULL,
    frozen_balance BIGINT NOT NULL,
    CHECK (total_balance = available_balance + frozen_balance)
);

CREATE TABLE fund_freeze (
    freeze_id BIGINT PRIMARY KEY AUTO_INCREMENT,
    account_id BIGINT NOT NULL,
    freeze_request_no VARCHAR(64) NOT NULL,
    release_request_no VARCHAR(64) NULL,
    freeze_type VARCHAR(32) NOT NULL,
    amount BIGINT NOT NULL,
    status VARCHAR(16) NOT NULL,
    expire_at DATETIME NULL,
    UNIQUE KEY uk_freeze_request (freeze_request_no),
    UNIQUE KEY uk_release_request (release_request_no)
);

INSERT INTO merchant_account
VALUES (1001, 100000, 100000, 0);

DELIMITER $$

CREATE PROCEDURE freeze_funds(
    IN p_account_id BIGINT,
    IN p_request_no VARCHAR(64),
    IN p_type VARCHAR(32),
    IN p_amount BIGINT,
    IN p_expire_at DATETIME
)
BEGIN
    DECLARE v_status VARCHAR(16);
    DECLARE EXIT HANDLER FOR SQLEXCEPTION
    BEGIN
        ROLLBACK;
        RESIGNAL;
    END;

    START TRANSACTION;

    INSERT INTO fund_freeze(
        account_id, freeze_request_no, freeze_type,
        amount, status, expire_at
    )
    VALUES (
        p_account_id, p_request_no, p_type,
        p_amount, 'INIT', p_expire_at
    )
    ON DUPLICATE KEY UPDATE
        freeze_request_no = VALUES(freeze_request_no);

    SELECT status
      INTO v_status
      FROM fund_freeze
     WHERE freeze_request_no = p_request_no
     FOR UPDATE;

    IF v_status = 'INIT' THEN
        UPDATE merchant_account
           SET available_balance = available_balance - p_amount,
               frozen_balance = frozen_balance + p_amount
         WHERE account_id = p_account_id
           AND available_balance >= p_amount;

        IF ROW_COUNT() = 0 THEN
            SIGNAL SQLSTATE '45000'
                SET MESSAGE_TEXT = 'insufficient available balance';
        END IF;

        UPDATE fund_freeze
           SET status = 'FROZEN'
         WHERE freeze_request_no = p_request_no;
    END IF;

    COMMIT;
END$$

CREATE PROCEDURE release_funds(
    IN p_freeze_request_no VARCHAR(64),
    IN p_release_request_no VARCHAR(64)
)
BEGIN
    DECLARE v_account_id BIGINT;
    DECLARE v_amount BIGINT;
    DECLARE v_status VARCHAR(16);
    DECLARE EXIT HANDLER FOR SQLEXCEPTION
    BEGIN
        ROLLBACK;
        RESIGNAL;
    END;

    START TRANSACTION;

    SELECT account_id, amount, status
      INTO v_account_id, v_amount, v_status
      FROM fund_freeze
     WHERE freeze_request_no = p_freeze_request_no
     FOR UPDATE;

    IF v_status = 'FROZEN' THEN
        UPDATE merchant_account
           SET available_balance = available_balance + v_amount,
               frozen_balance = frozen_balance - v_amount
         WHERE account_id = v_account_id
           AND frozen_balance >= v_amount;

        UPDATE fund_freeze
           SET status = 'RELEASED',
               release_request_no = p_release_request_no
         WHERE freeze_request_no = p_freeze_request_no;
    END IF;

    COMMIT;
END$$

DELIMITER ;

CALL freeze_funds(
    1001, 'FRZ-20260803-001', 'RISK', 30000,
    '2026-08-10 00:00:00'
);

SELECT total_balance, available_balance, frozen_balance
FROM merchant_account
WHERE account_id = 1001;

CALL release_funds(
    'FRZ-20260803-001', 'REL-20260803-001'
);

SELECT total_balance, available_balance, frozen_balance
FROM merchant_account
WHERE account_id = 1001;

SELECT freeze_request_no, release_request_no, amount, status
FROM fund_freeze;

预期输出

text
冻结后:
total_balance=100000, available_balance=70000, frozen_balance=30000

解冻后:
total_balance=100000, available_balance=100000, frozen_balance=0

冻结记录:
FRZ-20260803-001 | REL-20260803-001 | 30000 | RELEASED

实际生产代码通常由应用服务开启事务并执行相同的锁定顺序。动态时间、记录 ID 和数据库生成值会不同,但余额不变量与状态结果应保持一致。

到期自动解冻

自动解冻任务只扫描 status='FROZEN' 且 expire_at <= 当前时间 的记录,并为每条记录生成稳定的释放请求号,例如 AUTO-<freeze_id>。多节点部署时,应使用数据库抢占、分布式锁或消息队列分片,保证同一条记录只被一个工作节点处理。

批量任务不能直接先改账户再改状态。应逐笔调用与人工解冻相同的事务入口,并限制单批数量。某条记录失败时只记录失败原因并重试,不应回滚整批已经完成的解冻。

边界与核对

余额不足时,账户更新的受影响行数必须为零,并让事务回滚。找不到冻结记录、金额小于等于零、账户与冻结记录不匹配时也应拒绝处理。同一幂等请求号若携带了不同账户、金额或冻结类型,不能按成功返回,而应判定为参数冲突。

复核时至少检查三项:账户余额不变量成立;每个冻结请求号只对应一条记录;RELEASED 记录不会再次增加可用余额。对高风险人工解冻,还应记录操作人、复核人、原因和审计时间。

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

目录与阅读设置

阅读设置

17

记录一个想法

冻结与解冻

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

登录哪都通