智能合约与以太坊 / 系统课时
把攻击步骤固化为回归测试
把攻击步骤固化为回归测试
修复智能合约漏洞后,不能只检查正常业务是否还能运行,还要证明原来的攻击路径已经被阻断。本课使用 Foundry 构造一个可复现的重入攻击:先让测试在漏洞版本上确认攻击成功,再把相同测试用于修复版本,验证攻击交易回滚且用户资金保持不变。
学习目标
- 使用 Foundry 将重入攻击的前置条件、攻击动作和获利结果写成自动化测试。
- 区分漏洞复现测试与修复回归测试,避免把攻击交易回滚误判为测试失败。
- 通过余额断言、回滚断言和重复执行,验证补丁确实阻断了原有攻击路径。
确定可验证的攻击场景
假设一个 ETH 金库提供存款和提款功能。漏洞版本在提款时先向调用者发送 ETH,再扣减内部余额。攻击合约可以在收到 ETH 时通过 receive() 再次调用 withdraw(),利用余额尚未扣减的时间窗口重复提款。
本实验使用三个参与者:金库、正常存款人和攻击者。正常存款人向金库存入 10 ETH,攻击者存入 1 ETH。攻击者第一次提款应得 1 ETH,但漏洞可能让攻击合约累计取得 2 ETH,多拿的 1 ETH 来自其他存款。

回归测试需要观察的不是单纯的函数返回值,而是资金变化。测试条件设为:
| 检查项 | 漏洞版本 | 修复版本 |
|---|---|---|
| 初始金库余额 | 11 ETH | 11 ETH |
| 攻击交易 | 成功 | 回滚 |
| 攻击后攻击者合约余额 | 2 ETH | 0 ETH |
| 攻击后金库 ETH 余额 | 9 ETH | 11 ETH |
表中 0 ETH 指攻击交易回滚后攻击者合约的链上余额;攻击者用于存款的 1 ETH 同样随交易回滚。测试会通过 vm.deal 赋予攻击者地址足够的 ETH,但这不代表攻击已经产生收益。
准备可复现的漏洞与补丁
使用 Foundry 稳定版,要求 forge --version 能正常执行。以下示例使用 Solidity 0.8.24,依赖 Foundry 内置测试作弊码和 forge-std/Test.sol。先创建项目并进入目录:
forge init reentrancy-regression
cd reentrancy-regression
forge --version预期结果:初始化命令创建 src、test、lib 等目录,版本命令显示实际安装的 Forge 版本,具体版本字符串因环境而异。
创建 src/Vaults.sol,同时保留漏洞版本和修复版本,以便执行完全相同的攻击场景。
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
contract VulnerableVault {
mapping(address => uint256) public balances;
function deposit() external payable {
balances[msg.sender] += msg.value;
}
function withdraw() external {
uint256 amount = balances[msg.sender];
require(amount > 0, "no balance");
// 漏洞:外部调用发生在余额更新之前
(bool ok, ) = msg.sender.call{value: amount}("");
require(ok, "transfer failed");
balances[msg.sender] = 0;
}
}
contract FixedVault {
mapping(address => uint256) public balances;
function deposit() external payable {
balances[msg.sender] += msg.value;
}
function withdraw() external {
uint256 amount = balances[msg.sender];
require(amount > 0, "no balance");
// 先完成状态更新,再进行外部交互
balances[msg.sender] = 0;
(bool ok, ) = msg.sender.call{value: amount}("");
require(ok, "transfer failed");
}
}修复采用 Checks-Effects-Interactions 顺序。首次提款在发送 ETH 前将攻击合约的内部余额置零,因此回调中的第二次 withdraw() 会触发 no balance。因为攻击合约不捕获这次失败,回滚将继续向上传播,首次转账和首次余额修改也会撤销。
这里的修复只覆盖这个最小示例。真实金库还需要审查跨函数重入、共享状态、授权控制及是否需要 ReentrancyGuard,不能仅凭一个测试宣称整个合约不存在重入漏洞。
编写攻击合约与回归断言
创建 test/ReentrancyRegression.t.sol。攻击合约只需知道存款和提款接口,便能对两个金库执行同一个动作。通过 attacking 标志限制回调行为,避免正常收款也自动触发重入。
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
import {Test} from "forge-std/Test.sol";
import {VulnerableVault, FixedVault} from "../src/Vaults.sol";
interface IVault {
function deposit() external payable;
function withdraw() external;
}
contract ReentryAttacker {
IVault public immutable vault;
bool private attacking;
uint256 private callbacks;
constructor(address target) {
vault = IVault(target);
}
function attack() external payable {
require(msg.value == 1 ether, "send 1 ETH");
vault.deposit{value: msg.value}();
attacking = true;
vault.withdraw();
attacking = false;
}
receive() external payable {
// 最多重入一次,使漏洞版本确定取出 2 ETH
if (attacking && callbacks == 0) {
callbacks = 1;
vault.withdraw();
}
}
}
contract ReentrancyRegressionTest is Test {
address private constant USER = address(0xBEEF);
address private constant ATTACKER = address(0xCAFE);
function seedVault(IVault vault) internal {
vm.deal(USER, 10 ether);
vm.prank(USER);
vault.deposit{value: 10 ether}();
vm.deal(ATTACKER, 1 ether);
}
function testVulnerableVaultCanBeDrained() public {
VulnerableVault vault = new VulnerableVault();
seedVault(IVault(address(vault)));
ReentryAttacker attacker = new ReentryAttacker(address(vault));
vm.prank(ATTACKER);
attacker.attack{value: 1 ether}();
// 攻击者只投入 1 ETH,却取得 2 ETH
assertEq(address(attacker).balance, 2 ether);
assertEq(address(vault).balance, 9 ether);
}
function testFixedVaultRejectsSameAttack() public {
FixedVault vault = new FixedVault();
seedVault(IVault(address(vault)));
ReentryAttacker attacker = new ReentryAttacker(address(vault));
vm.prank(ATTACKER);
vm.expectRevert();
attacker.attack{value: 1 ether}();
// 回滚必须撤销攻击交易中的存款与转账
assertEq(address(vault).balance, 10 ether);
assertEq(address(attacker).balance, 0);
assertEq(vault.balances(address(attacker)), 0);
}
}需要注意:修复测试中,攻击发生前金库只有正常用户存入的 10 ETH。攻击者的 1 ETH 是在 attack() 交易中存入的,因此攻击失败后恢复到 10 ETH,而不是 11 ETH。前面表格中的 11 ETH 则表示攻击者完成存款之后、发起提款之前的余额快照,两种观察时点不能混用。
vm.expectRevert() 放在 attacker.attack() 前,断言该外部调用整体回滚。使用通用回滚断言是为了允许底层错误向上传播;本例中,FixedVault 的重入调用首先触发 no balance,但外层可能将其包装成 transfer failed。只匹配最外层错误文本会使测试和实现细节过度耦合。
运行测试并验证修复确实有效
在项目根目录运行定向测试:
forge test --match-contract ReentrancyRegressionTest -vv预期结果(省略耗时、Gas 和编译日志):
[PASS] testFixedVaultRejectsSameAttack()
[PASS] testVulnerableVaultCanBeDrained()
Test result: ok. 2 passed; 0 failed两个测试都通过才是正确结果。漏洞测试通过意味着成功复现攻击;修复测试通过意味着相同攻击动作触发了预期回滚。不要把漏洞测试的通过误读为合约安全,也不要把修复后的交易回滚误读为测试框架失败。
为了确认断言不会产生假阳性,还应执行一次负向校验:临时把 FixedVault.withdraw() 中的 balances[msg.sender] = 0; 移到外部调用之后,使其恢复漏洞顺序,然后重新运行修复测试。
预期结果:testFixedVaultRejectsSameAttack 失败,因为攻击交易不再回滚。恢复正确顺序后再次运行,测试恢复通过。这相当于验证测试本身能够识别补丁是否被撤销。
除了恶意路径,还应补充正常提款的业务测试。例如向修复金库存入 1 ETH,提款后断言提款人实际收到 1 ETH、金库余额减少 1 ETH、内部余额归零。否则一个简单地禁止所有提款的错误补丁,也可能通过只检查攻击回滚的测试。
将攻击回归纳入持续集成
将测试文件与补丁一同提交版本库。在 CI 中执行固定命令,让每次合并请求都重复检查攻击场景。
forge test --match-contract ReentrancyRegressionTest预期结果:两个回归用例通过时命令以退出码 0 结束;出现断言失败或编译失败时返回非零退出码,CI 应据此阻止合并。提交前还应运行完整的 forge test,避免补丁破坏其他业务测试。
评审时至少核对三个事实:漏洞版本能稳定复现超额提款,修复版本对同一个攻击动作产生回滚,正常用户仍可以提款。不要只检查是否抛出某个错误,因为余额断言能够进一步发现部分回滚、意外转账和测试初始条件不一致的问题。
真正有价值的回归用例应保留攻击的最小必要条件、明确记录预期资金变化,并在补丁被错误撤销时立即失败。这样,原本一次性的漏洞复现才能成为后续代码变更的持续安全检查。