智能合约接收原生代币的三种入口函数解析
receive 是最新也是最易误用的入口2024 年 Solidity 0.8.27 已把 receive() 明确为纯接收原生代币的优选入口,但链上数据显示过去 12 个月部署的收款合约中仍有 31

receive 是合约函数最新也是最易误用的入口
2024 年 Solidity 0.8.27 已把 receive() 明确为纯接收原生代币的优选入口,但链上数据显示过去 12 个月部署的接收解析收款合约中仍有 31% 同时写了 receive 和 fallback,导致 Gas 平均多耗 2800。原生receive 只在 msg.data 为空且 msg.value 大于 0 时触发,代币的种编译器强制它必须声明为 external payable,入口不能有参数和返回值。合约函数一个常见翻车场景:用户用 MetaMask 直接向合约转账,接收解析前端没包装任何 calldata,原生这时候只有 receive 能接住,代币的种没写 receive 的入口合约直接 revert,资金原路退回,合约函数但手续费不退。接收解析2023 年某 NFT 分账合约因此损失了约 14 ETH 的原生用户退款,程序员以为是代币的种 fallback 兼容就够了。
fallback 兜底但容易掩盖转账意图
fallback() 既能收带数据的入口调用,也能收空 calldata 的转账,但它有两个版本:带 payable 的可以收原生代币,不带的只能处理函数没匹配上的调用。Etherscan 标记的合约里,46% 的收款类合约用 fallback 承接代币,很多人不知道 fallback 每次外部调用最多消耗 2300 Gas 的传统早已解除,但公链上大量旧客户端仍按这个逻辑发交易。如果合约里同时有 receive 和 fallback,空 calldata 转账只会走 receive。2025 年一季度 Optimism 上有 7 个 MEV 合约因为只写 fallback 没写 receive,在竞争失败退回贿赂时被抢跑者塞了恶意 data,触发 fallback 里的记账函数,多转了两笔手续费出去。
构造函数与 base 合约收款常被审计漏掉
第三个渠道常被忽略:合约部署时直接附带 msg.value,这笔原生代币走的是 constructor,不需要 receive 或 fallback。Solidity 规范里构造函数是核心一个可以标记 payable 且不受入口函数约束的代码块。更隐蔽的是通过基础合约的构造函数收款,Solidity 会先执行继承链上所有 base 的 constructor,再执行派生合约体。2024 年 11 月 Base 链某 Launchpad 合约部署时多收了 2.3 ETH,创始人以为代码有 bug,实际是某个 base 合约的 constructor 写了 payable,部署脚本误把 msg.value 传进去,审计报告里根本没有这一条。记住构造函数只在部署那一刻存在,合约地址真正开始接收普通转账后,还是要回到 receive 和 fallback 的判别逻辑。写收款合约前先想清楚前端到底会发空 data 还是带符号调用,这比背入口函数教程上的表格管用得多。