智能合约与以太坊 / 系统课时
检查 fallback 收款入口
检查 fallback 收款入口
向合约转入 ETH 时,空数据与非空数据可能触发不同的接收函数,甚至导致交易回滚。本课使用 Solidity 和 Foundry 复现两种转账,检查 receive、fallback 的选择规则、余额变化与外部回调风险,最后建立可重复执行的审计检查方法。
学习目标
- 区分空 calldata、未知函数选择器与
receive、fallback的对应关系。 - 使用 Foundry 验证带数据和不带数据的 ETH 转账结果。
- 判断收款入口是否存在拒绝服务、意外收款或重入风险。
收款入口怎样选择
Solidity 0.6.0 起将传统 fallback 拆分为 receive 和 fallback。以下规则适用于 Solidity 0.8.x,前提是接收地址已有合约代码,且不存在匹配的普通函数调用。
| 调用条件 | 执行入口 | ETH 接收条件 |
|---|---|---|
| calldata 为空,存在 receive | receive() |
receive 必须 payable |
| calldata 为空,无 receive | fallback() |
fallback 必须 payable |
| calldata 非空,未匹配函数 | fallback() |
携带 ETH 时必须 payable |
| calldata 匹配普通函数 | 匹配的函数 | 携带 ETH 时函数必须 payable |
这里的 calldata 指交易传入的调用数据,而不是 ETH 数量。因此,发送 0 ETH 也可以触发 receive;发送 1 ETH 但携带未知函数选择器,则会进入 fallback。

审计时还要注意:合约没有 receive,并不意味着不能直接收款;可支付的 fallback 仍能接收空数据调用。反过来,只有 receive 而没有 fallback 的合约,收到未知函数选择器时仍会回滚。
用 Foundry 复现两种转账
准备已安装 Foundry 的环境,执行以下命令创建项目并进入目录。示例使用 Solidity 0.8.24,可在支持该编译器版本的 Foundry 环境运行。
forge init fallback-audit
cd fallback-audit预期结果:当前目录生成 foundry.toml、src、test 和 lib 等项目内容。项目内应包含 forge-std 测试依赖。
在 test/FallbackEntry.t.sol 创建以下完整测试文件。接收合约分别记录两种入口的调用次数和金额;测试合约使用底层 call 模拟带数据及不带数据的 ETH 转账。
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
import {Test} from "forge-std/Test.sol";
contract PaymentReceiver {
uint256 public receiveCount;
uint256 public fallbackCount;
uint256 public receiveAmount;
uint256 public fallbackAmount;
bytes32 public lastDataHash;
receive() external payable {
receiveCount++;
receiveAmount += msg.value;
}
fallback() external payable {
fallbackCount++;
fallbackAmount += msg.value;
lastDataHash = keccak256(msg.data);
}
}
contract NonPayableFallback {
fallback() external {
// 不允许携带 ETH 调用此入口
}
}
contract FallbackEntryTest is Test {
PaymentReceiver receiver;
function setUp() public {
receiver = new PaymentReceiver();
vm.deal(address(this), 10 ether);
}
function testEmptyCalldata() public {
// 空数据且携带 1 ETH,应进入 receive
(bool ok, ) = address(receiver).call{value: 1 ether}("");
assertTrue(ok);
assertEq(receiver.receiveCount(), 1);
assertEq(receiver.fallbackCount(), 0);
assertEq(receiver.receiveAmount(), 1 ether);
assertEq(address(receiver).balance, 1 ether);
}
function testNonEmptyCalldata() public {
bytes memory payload = hex"deadbeef";
// 未知选择器携带 2 ETH,应进入 payable fallback
(bool ok, ) = address(receiver).call{value: 2 ether}(payload);
assertTrue(ok);
assertEq(receiver.receiveCount(), 0);
assertEq(receiver.fallbackCount(), 1);
assertEq(receiver.fallbackAmount(), 2 ether);
assertEq(receiver.lastDataHash(), keccak256(payload));
assertEq(address(receiver).balance, 2 ether);
}
function testNonPayableFallbackRejectsEther() public {
NonPayableFallback target = new NonPayableFallback();
(bool ok, ) = address(target).call{value: 1 ether}(
hex"deadbeef"
);
assertFalse(ok);
assertEq(address(target).balance, 0);
}
}运行测试:
forge test --match-contract FallbackEntryTest预期结果:testEmptyCalldata、testNonEmptyCalldata 和 testNonPayableFallbackRejectsEther 均通过,汇总结果为 3 个通过、0 个失败。具体 gas 消耗及输出路径可能因 Foundry 版本不同而变化。
这三个测试分别确认:空数据执行 receive,非空未知数据执行 fallback,非 payable 的 fallback 拒绝带 ETH 的调用。低级 call 失败时返回 false,本例没有使用 require(ok),因此第三个测试本身不会回滚。
追踪余额与外部回调
收款入口的审计不能只检查调用是否成功,还要追踪实际执行后的状态。对于一个原本余额为 0 的接收合约,两种独立测试的预期结果如下:
| 检查项 | 空数据转 1 ETH | 非空数据转 2 ETH |
|---|---|---|
| 执行入口 | receive | fallback |
| receiveCount | 1 | 0 |
| fallbackCount | 0 | 1 |
| 接收余额 | 1 ETH | 2 ETH |
| 调用结果 | true | true |
表中两列对应独立的 setUp 测试环境,不应错误地把余额相加。若两次交易连续发送给同一实例,且都成功,则最终余额为 3 ETH,两种计数器各为 1。
进一步审计真实收款合约时,应观察外部回调。假设资金合约 Vault 在提款时先向用户合约发送 ETH,而用户合约的 receive 又调用 Vault.withdraw(),便可能在前一次提款尚未更新账本前重新进入提款函数。

call{value: amount}("") 通常会向接收合约转发较多可用 gas,因此接收入口可能修改状态,甚至再次调用发送方合约。仅凭接收函数没有显式调用 withdraw,不能排除其调用其他合约后间接重入的可能。
防护应从发送方入手:使用 Checks-Effects-Interactions 顺序,先检查余额,再扣减内部账本,最后进行外部转账;必要时增加重入锁。接收方通常也应避免在 receive 中放置复杂业务逻辑。
检查 gas 限制与异常收款
使用 transfer 或 send 时,接收方通常只获得 2300 gas,这不足以完成普通的存储写入。前面测试中的 receive 会递增存储计数器,因此不能据此推断它能通过 transfer 成功收款。底层 call 不设置低 gas 上限时,可以执行更复杂的接收逻辑,但也扩大了外部回调的风险。
审计时可以按以下顺序检查:
- 检查
receive和fallback是否声明为payable,是否有白名单、权限校验或主动revert。 - 分别测试空数据、未知选择器、0 ETH 和非零 ETH,覆盖入口分派与拒收边界。
- 检查每次调用前后的 ETH 余额、存储变量和事件,确认失败交易没有留下不应存在的状态变化。
- 搜索收款函数调用的外部合约、代理转发或提款接口,并检查重入路径。
- 检查发送方是否正确处理
call的布尔返回值,是否把一次收款失败变成整个批量付款流程的拒绝服务。
还要区分普通消息调用收款与余额被动增加:部分协议级机制可能使合约余额增加,而不执行 receive 或 fallback。因此,address(this).balance 不能无条件等同于内部累计的存款账本。
对于真实审计,建议将本课的三组测试扩展为回归测试:要求正常收款成功、拒收场景失败且余额不变、重入尝试不能重复提取资金。只有入口选择、状态变化和外部回调三方面都得到验证,才能对 ETH 收款路径形成可信的安全判断。