架构与系统设计 / 系统课时
冻结与解冻
冻结与解冻
本课实现一套可落地的资金冻结机制:在不改变账户总额的前提下,将可用余额转入冻结余额,并通过幂等流水完成风险解除、保证金释放和到期自动解冻。
学习目标
- 理解总余额、可用余额和冻结余额之间的不变量
- 使用唯一请求号和事务实现幂等冻结、幂等解冻
- 设计到期扫描与异常补偿,避免资金被重复释放
资金冻结的账务本质
冻结不是扣款,也不是产生一笔新的资金。它只是在同一账户内部移动余额。若金额统一使用最小货币单位,例如人民币分,则任意时刻都应满足:
冻结金额为 时,可用余额减少 ,冻结余额增加 ;解冻时执行完全相反的变更。风险冻结、保证金冻结和人工冻结可以共用同一套账户动作,差异放在冻结类型、到期时间和解冻条件中表达。
冻结记录必须独立于账户表保存。账户表回答“现在有多少钱”,冻结记录回答“为什么被冻结、由哪个请求触发、何时可以释放”。若只修改账户余额而不记录业务流水,后续无法审计,也无法可靠地重试。
状态与执行流程
一笔冻结记录可以使用 INIT、FROZEN、RELEASED 三个核心状态。创建请求后先锁定冻结记录,再锁定账户并转移余额;解冻时只允许 FROZEN 转为 RELEASED。相同请求重复到达时,直接返回已有结果,不再次变更余额。

真正需要防止的不是“接口被调用两次”,而是“同一业务意图导致余额变更两次”。因此,幂等键应由调用方生成并落到唯一索引,例如 freeze_request_no。解冻也应使用独立的 release_request_no,并与原冻结记录关联。
可执行的数据库示例
下面脚本可在 MySQL 8.0 的空数据库中执行。示例金额均为分,先冻结 30000 分,再释放同一笔冻结。存储过程通过行锁、唯一请求号和异常回滚保证单次执行的一致性。
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;预期输出
冻结后:
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 记录不会再次增加可用余额。对高风险人工解冻,还应记录操作人、复核人、原因和审计时间。