智能合约与以太坊 / 系统课时

用 CEI 顺序修复余额更新

用 CEI 顺序修复余额更新

提款函数如果先向用户转账、再扣减内部余额,接收方就可能在余额尚未更新时再次调用提款函数。本篇通过一个可运行的 Solidity 示例复现这种重入攻击,再按检查、生效、交互(CEI)重排操作,最后运行回归测试确认攻击无法重复提取资金。

学习目标

  • 理解 Checks-Effects-Interactions(CEI)三个阶段及其安全边界。
  • 将存在重入风险的提款函数改造成先扣余额、后转账的实现。
  • 使用 Foundry 运行攻击回归测试,验证修复前后的行为差异。

为什么余额更新顺序会造成重入

假设一个资金池保存用户存款,攻击者存入 1 ETH 后调用提款。错误实现先执行外部转账,再更新 balances[msg.sender]。如果接收方是合约,其 receive() 函数便有机会在原提款函数尚未结束时再次调用 withdraw()。

危险代码如下,属于片段示例,依赖合约中已有的 balances 映射:

solidity
// 片段示例:存在重入风险的提款顺序
function withdraw(uint256 amount) external {
    require(balances[msg.sender] >= amount, "Insufficient");

    // 外部调用发生时,内部余额仍然有效
    (bool ok, ) = msg.sender.call{value: amount}("");
    require(ok, "Transfer failed");

    balances[msg.sender] -= amount;
}

问题在于 call 将执行机会交给了接收方,而提款合约依然记录攻击者拥有可提取余额。攻击者可以利用资金池中其他用户的存款重复提款。Solidity 0.8 及以上版本虽然默认检查整数下溢,但不能据此认为实现安全:在攻击者回退函数吞掉失败调用、或存在其他状态更新路径时,仍需要针对具体控制流检查风险。

错误提款顺序与CEI修复顺序对比

按 CEI 顺序改写提款

CEI 将提款流程划分为三个明确阶段:Checks 验证提款金额与余额;Effects 在合约内部扣减余额;Interactions 最后通过 call 向接收方发送 ETH。关键约束是:任何不可信外部调用发生前,与该操作相关的内部状态必须已更新。

下面是适用于 Solidity 0.8.24 的完整资金池合约。示例不包含管理员提款、手续费或复杂权限控制,只保留演示重入修复所需的功能。

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

contract SafeVault {
    mapping(address => uint256) public balances;

    function deposit() external payable {
        require(msg.value > 0, "Zero deposit");
        balances[msg.sender] += msg.value;
    }

    function withdraw(uint256 amount) external {
        // Checks:禁止零金额与超余额提款
        require(amount > 0, "Zero withdrawal");
        require(balances[msg.sender] >= amount, "Insufficient");

        // Effects:在不可信外部调用之前扣减余额
        balances[msg.sender] -= amount;

        // Interactions:最后执行 ETH 转账
        (bool ok, ) = msg.sender.call{value: amount}("");
        require(ok, "Transfer failed");
    }
}

这里使用 call{value: amount}(""),而不是把固定 2300 Gas 的 transfer 当作重入防护。call 可以向接收方转发更多 Gas,因此必须依靠正确状态顺序来保证提款安全。

如果转账失败,require(ok, ...) 会让整笔交易回滚,之前执行的余额扣减也会撤销。因此 CEI 不意味着转账失败后用户会损失内部余额。

用攻击测试确认修复有效

使用 Foundry 验证最直观。准备已安装 Foundry 的开发环境,在终端执行:

bash
forge init cei-lab
cd cei-lab

预期结果:生成 Foundry 项目,包含 foundry.toml、src 和 test 等目录。已有同名目录时应换一个项目名。

将上面的合约保存为 src/SafeVault.sol,然后将以下完整测试保存为 test/SafeVault.t.sol。测试先由普通用户存入 5 ETH,再让攻击合约存入 1 ETH。攻击者提款时,其 receive() 尝试二次提款,并通过低级调用记录是否成功,避免失败重入直接终止整个测试。

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

import {Test} from "forge-std/Test.sol";
import {SafeVault} from "../src/SafeVault.sol";

contract ReentryProbe {
    SafeVault public immutable vault;
    bool public reentered;
    bool public secondWithdrawalSucceeded;

    constructor(SafeVault target) {
        vault = target;
    }

    function deposit() external payable {
        vault.deposit{value: msg.value}();
    }

    function attack() external {
        vault.withdraw(1 ether);
    }

    receive() external payable {
        if (!reentered) {
            reentered = true;
            // 捕获重入失败,不让外层正常提款回滚
            (bool ok, ) = address(vault).call(
                abi.encodeCall(SafeVault.withdraw, (1 ether))
            );
            secondWithdrawalSucceeded = ok;
        }
    }
}

contract SafeVaultTest is Test {
    SafeVault vault;
    ReentryProbe probe;
    address depositor = address(0xBEEF);

    function setUp() public {
        vault = new SafeVault();
        probe = new ReentryProbe(vault);

        vm.deal(depositor, 5 ether);
        vm.prank(depositor);
        vault.deposit{value: 5 ether}();

        vm.deal(address(this), 1 ether);
        probe.deposit{value: 1 ether}();
    }

    function testReentryCannotWithdrawTwice() public {
        probe.attack();

        // 攻击者只能提现自己的 1 ETH
        assertTrue(probe.reentered());
        assertFalse(probe.secondWithdrawalSucceeded());
        assertEq(address(probe).balance, 1 ether);
        assertEq(vault.balances(address(probe)), 0);
        assertEq(address(vault).balance, 5 ether);
        assertEq(vault.balances(depositor), 5 ether);
    }
}

运行测试:

bash
forge test --match-test testReentryCannotWithdrawTwice -vv

预期结果:测试通过,终端会显示与下列内容类似的结果,实际 Gas 数值和耗时因 Foundry 版本而异。

text
[PASS] testReentryCannotWithdrawTwice()
Suite result: ok. 1 passed; 0 failed

测试中的关键证据不是单独的 PASS,而是四项断言:重入回调确实发生;第二次提款失败;攻击者只收到 1 ETH;资金池仍持有普通用户存入的 5 ETH。这样可以避免出现攻击路径根本没有触发、测试却误判修复成功的问题。

让回归测试识别旧漏洞

为了确认测试具有区分能力,可以暂时在本地实验副本中,将 SafeVault.withdraw 的余额扣减移到外部 call 之后,再运行同一个测试。

预期结果:testReentryCannotWithdrawTwice 应失败,因为它要求重入探测成功触发但第二次提款必须失败。对于这里的 Solidity 0.8.24 实现,重复提款可能在外层执行余额扣减时触发算术下溢,使整笔交易回滚;此时测试通常因 probe.attack() 回滚而失败,并不等于攻击者已经成功拿到额外 ETH。

这个负向验证需要特别注意两点。第一,不能把测试失败直接解释为资金已被盗取;第二,不能把旧代码因下溢回滚解释为满足了 CEI。正确的修复应在外部调用前就令重复提款不满足余额检查,而不是依赖后续异常清理危险执行路径。

测试完成后恢复 CEI 实现,再执行一次:

bash
forge test

预期结果:项目内所有有效测试通过;Foundry 初始模板中的示例测试也可能同时显示在结果中,具体数量以项目内容为准。

CEI 的适用边界

CEI 可以消除本例中因提款余额更新过晚产生的重入窗口,但不能保证所有外部调用场景安全。例如,同一合约还有其他使用共享资金状态的函数,攻击者可能改为调用那些函数,形成跨函数重入。

审查实际项目时,重点检查以下条件:

  • 所有与提款有关的余额、份额、限额及已领取标记,是否在外部调用前一致更新。
  • ERC777 回调、ERC721 安全转账回调以及对其他协议的调用,是否可能重新进入当前合约。
  • 接收方拒绝收款时,交易是否按预期回滚;是否需要改用由用户主动领取的 Pull Payment 模式。
  • 复杂合约是否还需要 OpenZeppelin ReentrancyGuard 的 nonReentrant 作为纵深防护,以及该修饰器是否覆盖了相关外部入口。

对于当前资金池,验收标准是:正常存款和提款保持可用,接收方二次进入提款函数时不能重复领取,转账失败时状态完全回滚。CEI 应作为资金转移函数的默认编码顺序,并与跨函数审计、失败路径测试共同使用。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 CEI 顺序修复余额更新

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

登录哪都通