智能合约与以太坊 / 系统课时
校验回滚原因和权限检查
校验回滚原因和权限检查
智能合约中的失败调用不一定代表测试失败。权限不足、余额不够或参数非法时,合约应主动回滚。本课使用 Foundry 的 vm.expectRevert 精确校验自定义错误与权限拒绝,并检查回滚后资金和存储状态是否保持不变。
学习目标
- 使用
vm.expectRevert验证自定义错误、错误参数和权限检查。 - 区分预期回滚、错误回滚原因与意外成功调用。
- 编写可运行的 Foundry 测试,确认失败交易没有留下状态变化。
明确需要验证的失败行为
假设有一个由管理员管理资金的合约,只有管理员可以提取资金,并且提款金额不能超过合约余额。
需要覆盖三条业务规则:
- 非管理员提款时,回滚并返回
Unauthorized(address caller)。 - 管理员提款超过余额时,回滚并返回
InsufficientBalance(uint256 available, uint256 requested)。 - 任何回滚都不能扣减合约余额、增加提款统计或向接收方转账。
Solidity 自定义错误可以携带结构化参数,比仅检查交易是否失败更适合定位权限缺陷。对安全敏感的路径,不能仅凭一次调用失败就认定授权逻辑正确。
例如,非管理员提款本应触发 Unauthorized,却因为余额不足触发 InsufficientBalance。如果测试只接受任意回滚,这种检查顺序错误可能被掩盖。
创建带权限限制的测试合约
以下示例适用于 Foundry、Solidity 0.8.20 及兼容的 Forge Standard Library。先在已经安装 Foundry 的环境中创建项目:
forge init revert-lab
cd revert-lab预期结果:项目创建成功,包含 src/、test/、foundry.toml,并在 lib/forge-std/ 下提供测试依赖。目录绝对路径随执行环境变化。
将下面的完整合约保存为 src/SecureVault.sol:
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract SecureVault {
error Unauthorized(address caller);
error InsufficientBalance(uint256 available, uint256 requested);
error TransferFailed();
address public immutable owner;
uint256 public withdrawalCount;
constructor() payable {
owner = msg.sender;
}
function withdraw(uint256 amount, address payable recipient) external {
// 先验证权限,避免非管理员通过其他错误探测提款路径。
if (msg.sender != owner) {
revert Unauthorized(msg.sender);
}
uint256 available = address(this).balance;
if (amount > available) {
revert InsufficientBalance(available, amount);
}
// 外部转账失败也必须撤销本次调用的状态修改。
withdrawalCount += 1;
(bool ok, ) = recipient.call{value: amount}("");
if (!ok) revert TransferFailed();
}
}owner 在部署时固定,withdrawalCount 用于观察持久化存储是否受到失败调用影响。合约先检查权限,再检查余额,最后执行提款。
这里的检查顺序也是测试契约的一部分:非管理员即使请求超过余额,也应该收到权限错误,而不是余额错误。
使用 expectRevert 精确匹配自定义错误
在 Foundry 中,vm.expectRevert 用于声明下一次匹配的外部合约调用应该回滚。可以通过 abi.encodeWithSelector 把错误选择器和参数编码为完整的 revert 数据。
将以下代码保存为 test/SecureVault.t.sol:
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
import {Test} from "forge-std/Test.sol";
import {SecureVault} from "../src/SecureVault.sol";
contract SecureVaultTest is Test {
SecureVault vault;
address attacker = address(0xBEEF);
address payable recipient = payable(address(0xCAFE));
function setUp() public {
// 测试合约作为管理员,向金库注入 10 ether。
vault = new SecureVault{value: 10 ether}();
}
function testUnauthorizedRevertsWithCaller() public {
bytes memory expectedError = abi.encodeWithSelector(
SecureVault.Unauthorized.selector,
attacker
);
vm.prank(attacker);
vm.expectRevert(expectedError);
vault.withdraw(1 ether, recipient);
}
function testInsufficientBalanceRevertsWithAmounts() public {
bytes memory expectedError = abi.encodeWithSelector(
SecureVault.InsufficientBalance.selector,
10 ether,
11 ether
);
vm.expectRevert(expectedError);
vault.withdraw(11 ether, recipient);
}
function testUnauthorizedRollbackKeepsState() public {
uint256 vaultBefore = address(vault).balance;
uint256 recipientBefore = recipient.balance;
uint256 countBefore = vault.withdrawalCount();
vm.prank(attacker);
vm.expectRevert(
abi.encodeWithSelector(SecureVault.Unauthorized.selector, attacker)
);
vault.withdraw(1 ether, recipient);
// 回滚后同时检查资产余额与持久化业务状态。
assertEq(address(vault).balance, vaultBefore);
assertEq(recipient.balance, recipientBefore);
assertEq(vault.withdrawalCount(), countBefore);
}
function testInsufficientBalanceRollbackKeepsState() public {
uint256 vaultBefore = address(vault).balance;
uint256 countBefore = vault.withdrawalCount();
vm.expectRevert(
abi.encodeWithSelector(
SecureVault.InsufficientBalance.selector,
10 ether,
11 ether
)
);
vault.withdraw(11 ether, recipient);
assertEq(address(vault).balance, vaultBefore);
assertEq(vault.withdrawalCount(), countBefore);
}
}这里需要区分三种匹配方式:
| 写法 | 校验范围 | 适用情况 |
|---|---|---|
vm.expectRevert() |
接受任意回滚数据 | 只关心调用必须失败 |
vm.expectRevert(SecureVault.Unauthorized.selector) |
匹配错误选择器 | 关心错误类型,不关心参数 |
vm.expectRevert(abi.encodeWithSelector(...)) |
匹配完整编码数据 | 必须同时验证错误类型与参数 |
本例采用第三种,避免传错调用者地址、余额或请求金额时测试仍然通过。
vm.prank(attacker) 只修改下一次外部调用的 msg.sender。在当前写法中,vm.expectRevert 是测试作弊码,目标外部调用仍是随后的 vault.withdraw(...)。如果需要让多个合约调用以同一身份执行,可以使用 vm.startPrank(attacker) 和 vm.stopPrank()。
运行测试并识别意外失败
在项目根目录执行:
forge test --match-contract SecureVaultTest -vv预期结果:四个测试均通过,最终汇总显示 4 passed; 0 failed。实际耗时、Gas 使用量、编译提示及输出路径会随环境不同而变化。
可以做两个有针对性的故障注入练习。
首先,暂时交换 withdraw 中权限检查与余额检查的顺序,然后将权限测试的提款金额改为 11 ether。正确的业务规则仍要求返回 Unauthorized(attacker),但修改后的合约会优先返回 InsufficientBalance。此时精确匹配测试应失败,说明回滚原因不符合预期。
其次,暂时删除 withdraw 内的权限检查,并保持攻击者请求 1 ether。调用不再按预期回滚,测试也应该失败。这证明 expectRevert 能发现意外成功,而不是把所有异常路径都当作通过。
完成练习后恢复合约逻辑,并再次执行 forge test,确认四个测试全部通过。
检查回滚后是否留下状态变化
EVM 中,正常的 revert 会撤销当前调用及其被回滚调用链中的持久化状态写入和 ETH 转账。即使某段逻辑在回滚前执行了写入,只要其所在调用最终被回滚,这些写入也不会持久化。
但测试仍然应该显式验证业务不变量,因为合约可能捕获下层调用失败后继续执行,也可能在失败前后采用错误的处理策略。
本例选择三个可以直接观测的状态:
| 检查项 | 调用前 | 回滚后期望 |
|---|---|---|
| 金库 ETH 余额 | 10 ether | 10 ether |
| 接收方 ETH 余额 | 原始余额 | 不变 |
withdrawalCount |
0 | 0 |
判断失败路径是否安全,至少要同时回答两个问题:调用是否按约定的错误原因失败,以及失败后关键状态是否仍符合业务约束。
还要注意,vm.expectRevert 不是模拟一次真实交易后再自动回滚测试状态;它是在测试执行过程中验证目标调用的回滚。测试中读取失败调用之后的合约状态,才能确认预期的状态不变量。
对于更复杂的权限系统,可以继续为每个角色分别增加测试,例如管理员允许提款、操作员只能暂停、普通用户不能修改管理员地址。每种拒绝路径都应覆盖错误类型、错误参数,以及对应资金和存储字段是否保持不变。