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

从执行轨迹定位回滚原因

从执行轨迹定位回滚原因

当 Solidity 交易失败时,仅看 execution reverted 往往无法判断是权限校验、参数错误,还是被调用合约拒绝执行。这里用一个可复现的 ETH 提款失败案例,读取 Forge 调用轨迹,找出最内层错误,并判断问题是否发生在 RPC 广播之前。

学习目标

  • 使用 forge test -vvvv 找到失败调用及其返回的 revert 信息。
  • 区分内层外部调用失败与外层合约主动回滚。
  • 根据错误出现的位置,判断应排查合约逻辑还是 RPC、签名与交易广播。

构造可复现的失败交易

前置条件是已安装 Foundry,终端能执行 forge --version。在 Bash 终端创建测试项目,以下命令会准备包含 forge-std 的默认工程:

bash
forge init trace-lab --no-git
cd trace-lab
test -f foundry.toml && test -d lib/forge-std && printf 'PROJECT_READY\n'

预期输出包含:

text
PROJECT_READY

新建 test/TraceWithdraw.t.sol,放入以下完整代码。金库预存 1 ether,收款合约会拒绝接收 ETH;金库没有直接向外透传内层错误,而是使用自己的 TRANSFER_FAILED 错误提示。

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

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

contract RejectReceiver {
    // 故意拒绝 ETH,用来复现跨合约调用失败。
    receive() external payable {
        revert("RECEIVER_REJECTED");
    }
}

contract TraceVault {
    address public immutable owner;

    constructor() payable {
        owner = msg.sender;
    }

    function withdraw(address payable to, uint256 amount) external {
        require(msg.sender == owner, "NOT_OWNER");
        require(amount > 0 && amount <= address(this).balance, "INVALID_AMOUNT");

        (bool ok, ) = to.call{value: amount}("");
        // 低级 call 返回 false,外层在此选择主动回滚。
        require(ok, "TRANSFER_FAILED");
    }
}

contract TraceWithdrawTest is Test {
    TraceVault private vault;
    RejectReceiver private receiver;

    function setUp() public {
        vm.deal(address(this), 1 ether);
        vault = new TraceVault{value: 1 ether}();
        receiver = new RejectReceiver();
    }

    function testFailureTrace() public {
        // 故意不捕获回滚,让 Forge 展示失败轨迹。
        vault.withdraw(payable(address(receiver)), 0.2 ether);
    }

    function testExpectedRevert() public {
        // 验证外层 Error(string) 的完整 ABI 编码。
        vm.expectRevert(abi.encodeWithSignature("Error(string)", "TRANSFER_FAILED"));
        vault.withdraw(payable(address(receiver)), 0.2 ether);
        assertEq(address(vault).balance, 1 ether);
    }
}

文件属于测试工程的一部分,forge-std/Test.sol 由项目依赖提供;代码在本地 EVM 运行,无需钱包私钥或公共 RPC。

从轨迹最内层向外定位

只运行刻意失败的用例,并打开详细执行轨迹:

bash
forge test --match-contract TraceWithdrawTest --match-test testFailureTrace -vvvv

预期输出的关键行(省略其他日志)如下:

text
[FAIL: revert: TRANSFER_FAILED] testFailureTrace() (gas: <GAS>)

其中 <GAS> 为随编译器与版本变化的数值。轨迹里还会出现 RejectReceiver 对 RECEIVER_REJECTED 的回滚,调用地址与排版也可能不同。-vvv 显示失败测试的轨迹,-vvvv 显示所有测试的轨迹。

阅读时按三层逐步定位:

  1. 找到测试调用 TraceVault.withdraw,确认传入金额为 0.2 ether,而金库初始余额是 1 ether。
  2. 向内追踪带 ETH 的 call:RejectReceiver.receive 执行并以 RECEIVER_REJECTED 回滚;低级 call 因而返回 ok=false。
  3. 向外追踪 require(ok, "TRANSFER_FAILED"):金库抛出新的错误,所以测试最终看到的是 外层错误,并非接收者的原始 revert 字符串。

ETH 提款回滚的内外层调用与错误传播

判断失败停在了哪一层

同一个 withdraw 在不同输入下会停止在不同位置,不能只盯着最终的 FAIL。

条件 首个失败位置 预期外层错误
msg.sender != owner 权限 require NOT_OWNER
管理员传入 amount=0 或 amount>1 ether 金额与余额 require INVALID_AMOUNT
管理员提款 0.2 ether 给拒收合约 接收者 receive,随后金库 require(ok) TRANSFER_FAILED

排查顺序应是:先读最终 revert 数据,再向内找最早发生的失败调用,最后核对其前面的 msg.sender、msg.value、合约余额和传参。若出现 Panic(uint256),还要检查越界、溢出等 Solidity 运行时错误;自定义错误通常会显示名称和参数,或以 4 字节 selector 与 ABI 编码参数呈现。

区分 EVM 回滚和 RPC 广播问题

forge test 默认在本地 EVM 执行,上述失败不涉及 Sepolia RPC。如果错误只在脚本广播或钱包发送交易时出现,先确认交易有没有进入 EVM 执行。

  • 合约执行层:本地轨迹、eth_call 或 Gas 预估返回 revert 数据,优先核对链上合约地址、调用者、参数与当前状态。Gas 预估时的 revert 不代表已广播成功。
  • RPC 或交易池层:HTTP 429、连接超时、nonce too low、insufficient funds 等,多半发生在请求处理或交易接受阶段;排查 RPC 可用性、链 ID、nonce、签名账户和支付 Gas 的 ETH。
  • 已上链交易:拿到交易哈希后再查询回执;status=0 才能认定该笔已上链交易执行失败,单凭广播返回哈希不能判定成功。

已配置 SEPOLIA_RPC_URL 的情况下,可先确认 RPC 指向的网络:

bash
cast chain-id --rpc-url "$SEPOLIA_RPC_URL"

预期输出(正确连接 Sepolia):

text
11155111

这只验证 RPC 可以响应并报告 Sepolia 链 ID,不表示账户余额足够,也不表示交易已经广播或确认。若命令超时或鉴权失败,应先处理节点连接问题,而不是修改 Solidity 的 require。

将回滚复现转成验收测试

定位到原因后,运行同一文件中的 testExpectedRevert。它以完整的 Error(string) ABI 数据匹配外层回滚,并检查失败后金库仍保有 1 ether:

bash
forge test --match-contract TraceWithdrawTest --match-test testExpectedRevert -vv

预期输出的关键行:

text
[PASS] testExpectedRevert() (gas: <GAS>)

测试通过证明当前输入下回滚原因符合预期,且提款没有改变金库余额。随后应针对权限拒绝、非法金额和成功提款分别补充测试;对于真实网络故障,则用 RPC 响应与链上回执排查,不把网络错误误判成合约回滚。

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

目录与阅读设置

阅读设置

17

记录一个想法

从执行轨迹定位回滚原因

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

登录哪都通