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

把攻击步骤固化为回归测试

把攻击步骤固化为回归测试

修复智能合约漏洞后,不能只检查正常业务是否还能运行,还要证明原来的攻击路径已经被阻断。本课使用 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。先创建项目并进入目录:

bash
forge init reentrancy-regression
cd reentrancy-regression
forge --version

预期结果:初始化命令创建 src、test、lib 等目录,版本命令显示实际安装的 Forge 版本,具体版本字符串因环境而异。

创建 src/Vaults.sol,同时保留漏洞版本和修复版本,以便执行完全相同的攻击场景。

solidity
// 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 标志限制回调行为,避免正常收款也自动触发重入。

solidity
// 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。只匹配最外层错误文本会使测试和实现细节过度耦合。

运行测试并验证修复确实有效

在项目根目录运行定向测试:

bash
forge test --match-contract ReentrancyRegressionTest -vv

预期结果(省略耗时、Gas 和编译日志):

text
[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 中执行固定命令,让每次合并请求都重复检查攻击场景。

bash
forge test --match-contract ReentrancyRegressionTest

预期结果:两个回归用例通过时命令以退出码 0 结束;出现断言失败或编译失败时返回非零退出码,CI 应据此阻止合并。提交前还应运行完整的 forge test,避免补丁破坏其他业务测试。

评审时至少核对三个事实:漏洞版本能稳定复现超额提款,修复版本对同一个攻击动作产生回滚,正常用户仍可以提款。不要只检查是否抛出某个错误,因为余额断言能够进一步发现部分回滚、意外转账和测试初始条件不一致的问题。

真正有价值的回归用例应保留攻击的最小必要条件、明确记录预期资金变化,并在补丁被错误撤销时立即失败。这样,原本一次性的漏洞复现才能成为后续代码变更的持续安全检查。

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

目录与阅读设置

阅读设置

17

记录一个想法

把攻击步骤固化为回归测试

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

登录哪都通