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

重放失败序列定位状态转移

重放失败序列定位状态转移

状态模糊测试发现失败后,真正需要确定的是哪一次调用改变了关键状态,以及哪些账户和参数共同触发缺陷。本课使用 Foundry 重放失败序列、逐步核对合约状态,并将随机反例整理成可重复执行的确定性回归测试。

学习目标

  • 读取 Foundry 不变量测试的失败调用序列,提取调用者、目标合约、参数和执行顺序。
  • 通过状态快照定位首次违反不变量的操作,区分触发调用与根本原因。
  • 将失败序列固化为独立测试,并在修复后验证回归结果。

从失败输出提取调用序列

Foundry 的不变量测试会对目标合约或 Handler 执行随机调用,并在调用之间检查不变量。一次运行可能包含几十次操作,但真正导致失败的通常只有其中几次。

假设一个资金池维护账户余额 balances 和总负债 totalLiabilities,要求总负债始终等于合约实际持有的 ETH。测试报告中的反例经过简化后可能包含以下三次调用:

  1. Alice 调用 deposit(),存入 10 ETH。
  2. Alice 调用 transferShares(Bob, 4 ether),把 4 ETH 对应的内部余额转给 Bob。
  3. Bob 调用 withdraw(4 ether),提取 4 ETH,随后不变量检查失败。

这里的 transferShares 只是合约内部记账转移,不会向外部发送 ETH。账户、金额与操作顺序都必须保留,不能把第三步单独执行后就认定它一定能触发相同问题。

定位反例时,需要记录四项信息:实际调用者 sender、调用目标 addr、函数选择器或解码后的函数及参数,以及失败前已成功执行的调用。特别注意,调用 Handler 时的外层 sender 不一定等于 Handler 通过 vm.prank 设置的业务调用者。

可以先在项目根目录运行:

bash
forge test --match-test invariant_totalLiabilities -vvvv

预期结果:当项目中存在名为 invariant_totalLiabilities 的失败测试时,Forge 会报告失败、不变量名称以及可用的反例调用序列;-vvvv 可提供更详细的执行轨迹。实际输出中的合约地址、调用次数和参数随测试而变化。

Foundry 会持久化不变量测试失败序列,并在后续测试中尝试重放。默认失败记录位于 ~/.foundry/cache/invariant/failures/ 下的对应测试目录。不要在提取反例前执行 forge clean,否则可能删除用于重放的缓存。

沿状态转移寻找首次偏差

定位时不能只看最后的 revert 或断言失败,还要比较每一步执行后的余额、负债和资金池实际资产。以下是本例预期的正确状态与存在缺陷时的实际状态,单位均为 ETH。

操作后状态 Alice余额 Bob余额 总负债 合约ETH
初始状态 0 0 0 0
Alice存入10 10 0 10 10
Alice转给Bob 4 6 4 10 10
Bob提取4(错误) 6 0 10 6
Bob提取4(正确) 6 0 6 6

第三步执行后,合约已经支付 4 ETH,但错误实现没有同步减少 totalLiabilities,导致账面负债比实际资产多出 4 ETH。该缺陷是资金池的会计状态更新遗漏,不代表 Alice 到 Bob 的内部转账本身存在错误。

失败调用序列与状态转移对照图

实际排查可以采用逐步缩减方法:先保留原始顺序重放,再尝试删除某个调用。如果删除转账仍能通过一次存款和一次提款触发问题,说明转账不是缺陷的必要前提。不过,简化时必须重新验证,不能仅凭观察推断两条序列等价。

写出确定性的失败回归测试

下面使用一个最小资金池重现问题。示例适用于 Solidity 0.8.24,并依赖通过 forge init 初始化的 Foundry 项目及其 forge-std 测试库。

将以下内容保存为 test/VaultReplay.t.sol。代码中的 withdraw 故意遗漏总负债更新,用于证明回归测试能够稳定捕获问题,不可直接用于生产合约。

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

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

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

    function deposit() external payable {
        balances[msg.sender] += msg.value;
        totalLiabilities += msg.value;
    }

    function transferShares(address to, uint256 amount) external {
        require(balances[msg.sender] >= amount, "insufficient");
        balances[msg.sender] -= amount;
        balances[to] += amount;
    }

    function withdraw(uint256 amount) external {
        require(balances[msg.sender] >= amount, "insufficient");
        balances[msg.sender] -= amount;
        // 故意遗漏 totalLiabilities -= amount,用于复现缺陷。
        (bool ok, ) = payable(msg.sender).call{value: amount}("");
        require(ok, "transfer failed");
    }
}

contract VaultReplayTest is Test {
    ReplayVault vault;
    address alice = makeAddr("alice");
    address bob = makeAddr("bob");

    function setUp() public {
        vault = new ReplayVault();
        vm.deal(alice, 10 ether);
    }

    function test_replayWithdrawalAccounting() public {
        vm.prank(alice);
        vault.deposit{value: 10 ether}();
        assertEq(vault.totalLiabilities(), 10 ether);

        vm.prank(alice);
        vault.transferShares(bob, 4 ether);
        assertEq(vault.balances(bob), 4 ether);

        vm.prank(bob);
        vault.withdraw(4 ether);

        // 检查最终状态,而不是依赖随机调用再次命中缺陷。
        assertEq(vault.balances(alice), 6 ether);
        assertEq(vault.balances(bob), 0);
        assertEq(vault.totalLiabilities(), address(vault).balance);
    }
}

示例通过 vm.deal 固定 Alice 的初始资金,通过 vm.prank 固定每次业务调用的发送者。setUp() 会在每个测试开始前重新部署资金池,因此不会继承其他测试的状态。

执行指定测试:

bash
forge test --match-test test_replayWithdrawalAccounting -vvvv

预期结果:测试稳定失败于最后一条 assertEq。此时 totalLiabilities() 为 10000000000000000000 wei,而 address(vault).balance 为 6000000000000000000 wei。具体失败日志格式可能随 Foundry 版本变化,但这两个数值与断言失败的位置应一致。

如果测试没有失败,先核对是否运行了正确的测试文件,再检查是否已经修复 withdraw、是否保留了相同的账户角色和金额,以及是否意外使用了不同部署实例。

验证修复并保留回归用例

本例缺陷的直接修复是在提款成功路径上减少总负债。对于当前代码,可在 withdraw 函数的余额扣减之后、外部 ETH 转账之前增加:

solidity
// 片段示例:位于 ReplayVault.withdraw 内部。
totalLiabilities -= amount;

该片段依赖前面已定义的 amount 参数和 totalLiabilities 状态变量。Solidity 交易具有原子性:若后续外部转账失败并 revert,这次总负债扣减也会回滚。提款时先更新内部状态再进行外部调用,还符合降低重入风险的基本操作顺序;实际生产合约仍需额外审查重入、强制转入 ETH 等边界。

修复后重新运行:

bash
forge test --match-test test_replayWithdrawalAccounting -vvvv

预期结果:test_replayWithdrawalAccounting 通过,Alice 余额为 6 ETH,Bob 余额为 0,总负债与合约余额均为 6 ETH。

最后还应执行完整测试:

bash
forge test

预期结果:在没有其他缺陷且现有测试断言成立的前提下,整个测试套件通过。若仍有失败,需要分别分析,不应仅凭这一条回归测试通过就认定所有不变量均已恢复。

处理无法稳定重放的序列

随机测试能够暴露复杂调用组合,但把反例转换成确定性测试时,最常遗漏的是环境条件。可以按下面顺序检查:

  1. 初始状态:重新执行部署、初始化和授权,确认测试不是从已经改变的链上状态开始。
  2. 账户身份:区分外层 Handler、实际业务调用者与资产接收者;检查 msg.sender 是否和失败时一致。
  3. 时间与区块:如果逻辑依赖时间锁或区块高度,使用 vm.warp、vm.roll 固定重放条件。
  4. 调用顺序:保持原顺序,先确认复现,再逐次删除非必要调用;每次删减后重新运行。
  5. 参数和金额:检查 msg.value、代币精度、余额、授权额度与舍入边界,不能把原始 wei 数值随意改成整数代币。
  6. 外部依赖:如果反例来自 fork 测试,应记录 RPC 网络、固定区块号以及相关外部合约状态,避免重放时使用变化的最新区块。

对依赖时间的用例,可以在调用前设置固定条件,例如:

solidity
// 片段示例:仅适用于继承 Test 的 Foundry 测试函数。
vm.warp(1_800_000_000);
vm.roll(20_000_000);

这两个 Cheatcode 分别设置测试 EVM 中的区块时间戳和区块高度,不会修改真实链。若反例不涉及时间或高度,不要额外加入这些设置,以免扩大测试前置条件。

可参考 Foundry 官方失败重放文档 核对持久化失败记录的行为,并通过 不变量测试文档 检查随机调用深度和不变量检测机制。

最终保留的回归测试应做到:单独执行即可稳定复现原缺陷,修复后可以通过,并且断言明确指向遭到破坏的状态约束。随机测试负责发现新的失败路径,确定性回归测试则负责防止已经定位的状态转移缺陷再次出现。

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

目录与阅读设置

阅读设置

17

记录一个想法

重放失败序列定位状态转移

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

登录哪都通