智能合约与以太坊 / 系统课时
用 Forge Fuzz 探索边界输入
用 Forge Fuzz 探索边界输入
智能合约在正常金额和固定账户下通过测试,不代表极小金额、不同调用者或连续提款时仍然安全。本课使用 Foundry 的 Forge Fuzz 自动生成测试输入,对一个 ETH 金库合约执行多账户存取操作,验证账户余额与合约资金约束,并学会定位和复现失败样本。
学习目标
- 使用
testFuzz、vm.assume和bound约束金额与账户输入。 - 编写双账户存取款模糊测试,检查资金守恒与账户隔离。
- 使用 Forge 执行、复现和分析失败样本,区分测试假设错误与真实漏洞。
理解 Fuzz 测试的输入空间
Forge 将带参数、名称以 testFuzz 开头的测试函数识别为模糊测试,并自动生成多组参数。与仅测试 1 ether 的普通单元测试相比,模糊测试能够覆盖零值、极大整数、不同地址以及其他容易遗漏的输入。
例如,一个存款函数接收 uint256 amount,其原始输入范围是 0 到 2^256 - 1。如果业务规定单笔存款不得超过 10 ether,就需要明确测试范围,而不能依赖随机数据恰好落在合理区间。
常用的输入处理方式如下:
| 方法 | 作用 | 适用情况 |
|---|---|---|
vm.assume(condition) |
不满足条件时丢弃当前输入 | 排除零地址、重复账户等无效组合 |
bound(value, min, max) |
将数值映射到指定闭区间 | 控制金额、时间和数组长度 |
vm.deal(account, amount) |
设置测试账户的 ETH 余额 | 为不同金额的存款准备资金 |
vm.prank(account) |
将下一次调用的 msg.sender 设为指定地址 |
模拟不同账户操作 |
vm.assume 不应大量用于限制整数范围。例如,直接假设随机 uint256 小于 10 ether,几乎所有随机值都会被丢弃,可能触发拒绝次数限制。金额范围优先使用 bound。
创建可测试的 ETH 金库
以下示例适用于使用 forge-std 测试库的 Foundry 项目。先在已有 Foundry 项目中创建 src/SecureVault.sol,使用 Solidity 0.8.24 编写一个包含存款、提款和余额查询的最小金库。
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
contract SecureVault {
mapping(address => uint256) public balances;
function deposit() external payable {
require(msg.value > 0, "ZERO_DEPOSIT");
balances[msg.sender] += msg.value;
}
function withdraw(uint256 amount) external {
require(amount > 0, "ZERO_WITHDRAW");
require(balances[msg.sender] >= amount, "INSUFFICIENT_BALANCE");
// 先更新内部账本,避免外部调用期间重复使用旧余额。
balances[msg.sender] -= amount;
(bool ok, ) = payable(msg.sender).call{value: amount}("");
require(ok, "TRANSFER_FAILED");
}
}这里使用 Checks-Effects-Interactions 顺序:先检查提款条件,再扣减余额,最后发送 ETH。外部转账失败时交易整体回滚,账本扣减也会回滚。
本次测试关注两个资金约束:正常存取后,合约持有的 ETH 应等于所有测试账户在金库中的余额之和;账户 A 提款时,账户 B 的内部余额不得发生变化。
该示例不处理第三方强制转入 ETH 等特殊情况,因此不能把“合约余额永远等于内部账本总额”无条件推广到任意主网部署环境。
编写金额与账户模糊测试
创建 test/SecureVault.t.sol,输入两个账户和两个金额。测试固定执行“账户 A 存款、账户 B 存款、账户 A 提款、账户 B 提款”的调用次序,并在关键位置检查资金约束。
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
import {Test} from "forge-std/Test.sol";
import {SecureVault} from "../src/SecureVault.sol";
contract SecureVaultFuzzTest is Test {
SecureVault vault;
function setUp() public {
vault = new SecureVault();
}
function testFuzz_DepositWithdraw(
address alice,
address bob,
uint256 rawAlice,
uint256 rawBob
) public {
// 排除影响测试独立性的账户组合。
vm.assume(alice != address(0) && bob != address(0));
vm.assume(alice != bob);
vm.assume(alice != address(this) && bob != address(this));
vm.assume(alice != address(vault) && bob != address(vault));
vm.assume(alice.code.length == 0 && bob.code.length == 0);
uint256 a = bound(rawAlice, 1 wei, 10 ether);
uint256 b = bound(rawBob, 1 wei, 10 ether);
vm.deal(alice, a);
vm.deal(bob, b);
// 两个账户分别存款,检查资金总量。
vm.prank(alice);
vault.deposit{value: a}();
vm.prank(bob);
vault.deposit{value: b}();
assertEq(address(vault).balance, a + b);
assertEq(vault.balances(alice), a);
assertEq(vault.balances(bob), b);
// A 提款不能影响 B 的账本。
vm.prank(alice);
vault.withdraw(a);
assertEq(address(vault).balance, b);
assertEq(vault.balances(bob), b);
assertEq(alice.balance, a);
vm.prank(bob);
vault.withdraw(b);
assertEq(address(vault).balance, 0);
assertEq(vault.balances(alice), 0);
assertEq(vault.balances(bob), 0);
assertEq(bob.balance, b);
}
}bound 将任意生成金额映射到 1 wei 至 10 ether,因此不会因随机金额超过测试账户资金而产生无关失败。两个测试账户分别注入恰好足够的 ETH,完成全部提款后,预期各自恢复原有资金。
这里用 alice.code.length == 0 和 bob.code.length == 0 排除普通合约账户,因为没有接收 ETH 能力的合约可能导致转账失败。它不是对任意地址均安全的判定,也不能可靠地排除所有特殊地址。测试 EOA 场景时还应注意预编译地址等特殊目标;若发现这类反例,需要单独处理,而不是把所有失败一概视为金额漏洞。
本测试仅覆盖一种固定操作顺序,金额与账户会变化,但调用顺序不会自动随机化。
执行测试并检查失败样本
在项目根目录执行以下命令。项目需要安装 Foundry,并能解析 forge-std/Test.sol;如果是新项目,可先运行 forge init 创建标准目录和测试依赖。
forge test --match-test testFuzz_DepositWithdraw -vvv预期结果:在支持上述 Solidity 编译版本且依赖齐全的项目中,测试通过,Forge 输出包含类似以下内容的结果。具体运行次数、Gas 数据及耗时因 Foundry 版本和配置而异。
[PASS] testFuzz_DepositWithdraw(address,address,uint256,uint256)
Suite result: ok. 1 passed; 0 failed若希望明确设置测试轮数,可在 foundry.toml 中加入以下配置片段。它依赖已有 Foundry 项目,修改后重新执行 forge test 生效。
[fuzz]
runs = 1000
max_test_rejects = 65536runs = 1000 表示每个 Fuzz 测试目标执行 1000 组有效输入;max_test_rejects 限制因假设不满足而被丢弃的输入次数。提高拒绝上限不能代替改进过严的前置条件。
如果测试失败,Forge 会报告反例参数。在支持失败样本持久化的 Foundry 版本中,默认还会保存可复现输入,后续重跑可能优先复用该样本。排查时应记录 Forge 版本、完整失败参数和失败断言,不要仅根据红色日志判断根因。
用真实错误验证断言是否有效
为了确认测试确实能够发现资金隔离问题,可以临时把 withdraw 中的余额扣减语句改为错误版本:
// 片段示例:仅用于本地故障注入,替换 SecureVault.withdraw 中的原扣减语句。
balances[msg.sender] = 0;这段代码在全额提款场景下仍可能通过,因为每次提款恰好提走该账户全部余额。因此,当前测试虽然验证了双账户隔离,却无法发现“部分提款错误清零”的缺陷。
应再补充一个针对部分提款的测试:
function testFuzz_PartialWithdraw(uint256 rawAmount) public {
uint256 amount = bound(rawAmount, 2 wei, 10 ether);
address user = makeAddr("partial-user");
vm.deal(user, amount);
vm.prank(user);
vault.deposit{value: amount}();
// 只提走 1 wei,剩余余额必须仍可使用。
vm.prank(user);
vault.withdraw(1 wei);
assertEq(vault.balances(user), amount - 1 wei);
assertEq(address(vault).balance, amount - 1 wei);
}该函数应添加在前面的 SecureVaultFuzzTest 合约内部,依赖原有的 Test、SecureVault 导入和 setUp 初始化。
预期结果:使用原始正确合约时测试通过;使用临时错误版本时,首次检查剩余账本余额的断言失败。因为金额至少为 2 wei,错误清零与正确剩余金额必然不同。
forge test --match-test testFuzz_PartialWithdraw -vvv确认测试能发现错误后,恢复 balances[msg.sender] -= amount;,再次执行测试,验证修复生效。
判断覆盖范围与测试局限
Fuzz 测试的质量取决于输入条件、操作顺序和断言,而不只是运行次数。对 ETH 金库可以使用以下验收表检查覆盖范围。
| 风险场景 | 本次覆盖情况 | 后续验证方式 |
|---|---|---|
| 极小金额及随机金额 | 已覆盖合法范围 | 额外断言零金额必须回滚 |
| 不同账户余额隔离 | 已覆盖双账户 | 增加第三账户操作 |
| 部分提款余额错误 | 已覆盖补充测试 | 变化提款比例与顺序 |
| 任意调用次序 | 未覆盖 | 使用状态机或不变量测试 |
| 恶意接收方重入 | 未覆盖 | 使用攻击合约模拟回调 |
| 第三方强制转入 ETH | 未覆盖 | 单独测试额外 ETH 的处理规则 |
对无效输入,应测试其正确回滚,而不是简单地用 vm.assume 全部排除。例如,零金额提款可以使用 vm.expectRevert 验证预期拒绝行为。对于实际部署的资产合约,还应测试权限、外部调用失败、重入和资产精度边界。
本次双账户 Fuzz 验证的是给定前置条件与操作序列下的资金约束。如果目标是覆盖随机存款、部分提款、转账和多账户交错操作,应升级为 Foundry 的 Stateful Invariant Testing,由 Handler 生成多步调用序列,并持续检查全局资产约束。