智能合约与以太坊 / 系统课时
从执行轨迹定位回滚原因
从执行轨迹定位回滚原因
当 Solidity 交易失败时,仅看 execution reverted 往往无法判断是权限校验、参数错误,还是被调用合约拒绝执行。这里用一个可复现的 ETH 提款失败案例,读取 Forge 调用轨迹,找出最内层错误,并判断问题是否发生在 RPC 广播之前。
学习目标
- 使用
forge test -vvvv找到失败调用及其返回的 revert 信息。 - 区分内层外部调用失败与外层合约主动回滚。
- 根据错误出现的位置,判断应排查合约逻辑还是 RPC、签名与交易广播。
构造可复现的失败交易
前置条件是已安装 Foundry,终端能执行 forge --version。在 Bash 终端创建测试项目,以下命令会准备包含 forge-std 的默认工程:
forge init trace-lab --no-git
cd trace-lab
test -f foundry.toml && test -d lib/forge-std && printf 'PROJECT_READY\n'预期输出包含:
PROJECT_READY新建 test/TraceWithdraw.t.sol,放入以下完整代码。金库预存 1 ether,收款合约会拒绝接收 ETH;金库没有直接向外透传内层错误,而是使用自己的 TRANSFER_FAILED 错误提示。
// 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。
从轨迹最内层向外定位
只运行刻意失败的用例,并打开详细执行轨迹:
forge test --match-contract TraceWithdrawTest --match-test testFailureTrace -vvvv预期输出的关键行(省略其他日志)如下:
[FAIL: revert: TRANSFER_FAILED] testFailureTrace() (gas: <GAS>)其中 <GAS> 为随编译器与版本变化的数值。轨迹里还会出现 RejectReceiver 对 RECEIVER_REJECTED 的回滚,调用地址与排版也可能不同。-vvv 显示失败测试的轨迹,-vvvv 显示所有测试的轨迹。
阅读时按三层逐步定位:
- 找到测试调用
TraceVault.withdraw,确认传入金额为0.2 ether,而金库初始余额是1 ether。 - 向内追踪带 ETH 的
call:RejectReceiver.receive执行并以RECEIVER_REJECTED回滚;低级call因而返回ok=false。 - 向外追踪
require(ok, "TRANSFER_FAILED"):金库抛出新的错误,所以测试最终看到的是 外层错误,并非接收者的原始 revert 字符串。

判断失败停在了哪一层
同一个 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 指向的网络:
cast chain-id --rpc-url "$SEPOLIA_RPC_URL"预期输出(正确连接 Sepolia):
11155111这只验证 RPC 可以响应并报告 Sepolia 链 ID,不表示账户余额足够,也不表示交易已经广播或确认。若命令超时或鉴权失败,应先处理节点连接问题,而不是修改 Solidity 的 require。
将回滚复现转成验收测试
定位到原因后,运行同一文件中的 testExpectedRevert。它以完整的 Error(string) ABI 数据匹配外层回滚,并检查失败后金库仍保有 1 ether:
forge test --match-contract TraceWithdrawTest --match-test testExpectedRevert -vv预期输出的关键行:
[PASS] testExpectedRevert() (gas: <GAS>)测试通过证明当前输入下回滚原因符合预期,且提款没有改变金库余额。随后应针对权限拒绝、非法金额和成功提款分别补充测试;对于真实网络故障,则用 RPC 响应与链上回执排查,不把网络错误误判成合约回滚。