智能合约与以太坊 / 系统课时
用 CEI 顺序修复余额更新
用 CEI 顺序修复余额更新
提款函数如果先向用户转账、再扣减内部余额,接收方就可能在余额尚未更新时再次调用提款函数。本篇通过一个可运行的 Solidity 示例复现这种重入攻击,再按检查、生效、交互(CEI)重排操作,最后运行回归测试确认攻击无法重复提取资金。
学习目标
- 理解 Checks-Effects-Interactions(CEI)三个阶段及其安全边界。
- 将存在重入风险的提款函数改造成先扣余额、后转账的实现。
- 使用 Foundry 运行攻击回归测试,验证修复前后的行为差异。
为什么余额更新顺序会造成重入
假设一个资金池保存用户存款,攻击者存入 1 ETH 后调用提款。错误实现先执行外部转账,再更新 balances[msg.sender]。如果接收方是合约,其 receive() 函数便有机会在原提款函数尚未结束时再次调用 withdraw()。
危险代码如下,属于片段示例,依赖合约中已有的 balances 映射:
// 片段示例:存在重入风险的提款顺序
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 将提款流程划分为三个明确阶段:Checks 验证提款金额与余额;Effects 在合约内部扣减余额;Interactions 最后通过 call 向接收方发送 ETH。关键约束是:任何不可信外部调用发生前,与该操作相关的内部状态必须已更新。
下面是适用于 Solidity 0.8.24 的完整资金池合约。示例不包含管理员提款、手续费或复杂权限控制,只保留演示重入修复所需的功能。
// 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 的开发环境,在终端执行:
forge init cei-lab
cd cei-lab预期结果:生成 Foundry 项目,包含 foundry.toml、src 和 test 等目录。已有同名目录时应换一个项目名。
将上面的合约保存为 src/SafeVault.sol,然后将以下完整测试保存为 test/SafeVault.t.sol。测试先由普通用户存入 5 ETH,再让攻击合约存入 1 ETH。攻击者提款时,其 receive() 尝试二次提款,并通过低级调用记录是否成功,避免失败重入直接终止整个测试。
// 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);
}
}运行测试:
forge test --match-test testReentryCannotWithdrawTwice -vv预期结果:测试通过,终端会显示与下列内容类似的结果,实际 Gas 数值和耗时因 Foundry 版本而异。
[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 实现,再执行一次:
forge test预期结果:项目内所有有效测试通过;Foundry 初始模板中的示例测试也可能同时显示在结果中,具体数量以项目内容为准。
CEI 的适用边界
CEI 可以消除本例中因提款余额更新过晚产生的重入窗口,但不能保证所有外部调用场景安全。例如,同一合约还有其他使用共享资金状态的函数,攻击者可能改为调用那些函数,形成跨函数重入。
审查实际项目时,重点检查以下条件:
- 所有与提款有关的余额、份额、限额及已领取标记,是否在外部调用前一致更新。
- ERC777 回调、ERC721 安全转账回调以及对其他协议的调用,是否可能重新进入当前合约。
- 接收方拒绝收款时,交易是否按预期回滚;是否需要改用由用户主动领取的 Pull Payment 模式。
- 复杂合约是否还需要 OpenZeppelin
ReentrancyGuard的nonReentrant作为纵深防护,以及该修饰器是否覆盖了相关外部入口。
对于当前资金池,验收标准是:正常存款和提款保持可用,接收方二次进入提款函数时不能重复领取,转账失败时状态完全回滚。CEI 应作为资金转移函数的默认编码顺序,并与跨函数审计、失败路径测试共同使用。