W2D3-Foundry 测试

Foundry 合约测试

Foundry 是一款基于 Rust 编写的高性能以太坊开发工具链。其核心组件 Forge 允许开发者直接使用 Solidity 编写高度可编程、可模拟且具备高性能的单元测试与集成测试。

一、测试框架体系架构

1.1 生命周期与状态管理

Foundry 的测试执行基于 EVM 的快照机制：

setUp() 函数 ：在每个测试用例（test*）执行前调用的初始化钩子。所有在 setUp 中创建的状态（部署合约、设置变量）都会在每个测试函数启动前重置为快照状态，确保测试用例之间的完全隔离。
继承体系 ：测试合约必须继承 forge-std/Test.sol。该标准库封装了底层的 Vm.sol 接口（即 vm 变量），提供了更高抽象的断言与工具函数。

1.2 访问控制与测试类型

内部测试 (Internal Testing) ：测试合约继承自被测合约，可以访问 internal 变量和函数。
外部测试 (External Testing)：通过接口或部署实例调用被测合约，更贴近真实链上交互场景。

二、作弊码 (Cheatcodes) 深度解析

作弊码通过非标准的 EVM 指令与 Forge 后端交互，允许测试合约在执行期间修改区块链的状态。

2.1 账户与身份模拟 (Account Impersonation)

身份模拟是权限测试的核心。

vm.prank(address sender) ：将下一次 外部调用的 msg.sender 更改为指定地址。
vm.startPrank(address sender) ：从此刻起，所有后续调用的 msg.sender 均被模拟，直至调用 vm.stopPrank()。
vm.deal(address who, uint256 amount)：强制修改指定账户的 ETH 余额。
vm.hoax(address who, uint256 amount) ：便捷方法，相当于同时执行 prank 和 deal。
vm.etch(address who, bytes memory code)：在指定地址注入特定的 Bytecode。

2.2 环境参数操纵 (Environment Manipulation)

允许开发者模拟特定的区块环境，测试时间敏感型逻辑。

vm.warp(uint256 newTimestamp) ：设置 block.timestamp。
vm.roll(uint256 newBlockNumber) ：设置 block.number。
vm.fee(uint256 newBaseFee)：设置区块的 Base Fee。
vm.chainId(uint256 id) ：设置 block.chainid。

2.3 预期与断言拦截 (Call Expectations)

vm.expectRevert(bytes memory message)：预期下一次调用会因特定的错误信息而回滚。如果调用未回滚或错误信息不匹配，测试将失败。
vm.expectEmit(bool checkTopic1, bool checkTopic2, bool checkTopic3, bool checkData, address emitter)：
- 针对下一次调用的事件发射进行校验。
- 前三个布尔值对应事件的 indexed 参数（Topics）。
- 第四个布尔值对应非索引参数（Data）。
- 实战案例：
  复制代码
```
vm.expectEmit(true, true, false, true);
emit Transfer(from, to, value); // 预期值
token.transfer(to, value);       // 触发值
```
vm.expectCall(address target, bytes memory data)：预期在当前交易中会对目标合约进行特定的静态或动态调用。

2.4 存储槽直接操作 (Storage Manipulation)

vm.load(address target, bytes32 slot)：读取合约特定存储槽的值。
vm.store(address target, bytes32 slot, bytes32 value)：绕过 Setter 函数直接覆盖存储状态。这在测试复杂、封装严密的私有状态时极度高效。

三、断言矩阵 (Assertions)

forge-std 提供的断言函数不仅验证结果，还能提供详尽的错误上下文。

3.1 基础数值断言

assertEq(uint a, uint b)：相等性检查。
assertGt(uint a, uint b) / assertLt：大于/小于。

3.2 精度与误差容忍

在涉及 DeFi 收益计算（如利息、滑点）时，由于精度舍入，完全相等往往难以实现。

assertApproxEqAbs(uint actual, uint expected, uint maxDelta) ：允许两个数值在 maxDelta 绝对值误差范围内。
assertApproxEqRel(uint actual, uint expected, uint maxPercentDelta)：允许在指定的百分比误差范围内。

四、高阶验证技术：模糊测试与不变量测试

4.1 模糊测试 (Fuzz Testing)

模糊测试通过提供伪随机输入，寻找合约在边界条件下的逻辑漏洞。

配置项 ：在 foundry.toml 中配置 runs（迭代次数）。
过滤机制 ：
- vm.assume(bool condition)：直接丢弃不满足条件的随机输入。若丢弃过多，Forge 会报错。
- bound(uint x, uint min, uint max) ：将随机数 x 映射到 [min, max] 区间。相比 assume，bound 能显著提高测试覆盖率和执行效率。

4.2 不变量测试 (Invariant Testing)

不变量测试是一种有状态的模糊测试，旨在验证合约在任何操作序列下都应保持不变的属性（如：总存款始终大于总负债）。

Open Testing：随机调用目标合约的所有公开函数。
Handler-based Testing ：
- 开发者编写一个 Handler 合约作为中间层。
- Handler 负责定义"合法的调用序列"，并在调用前后维护状态。
- 这种方式能大幅减少"无效路径"的探索，提升测试的深度与针å对性。

五、工具链与生产力优化

5.1 Gas 性能分析

forge test --gas-report：生成合约函数的 Gas 消耗统计，包括平均、最大和最小消耗，是优化 Gas 设计的必备工具。

5.2 代码覆盖率 (Coverage)

forge coverage：分析测试用例对合约源代码的覆盖程度。
-report lcov：导出标准格式报告，配合可视化插件（如 VSCode LCOV 插件）定位未覆盖的代码路径。

5.3 调试器 (Debugger)

forge debug：启动交互式调试界面，支持单步执行操作码、查看内存堆栈状态，是解决复杂逻辑错误的利器。

5.4 分叉测试 (Fork Testing)

vm.createSelectFork(string memory url, uint256 blockNumber)：在测试代码中动态克隆特定的主网快照。这使得在本地环境中与 Uniswap、Aave 等现有巨型协议进行交互测试成为可能，而无需手动部署它们的庞大代码库。