首页
学习
活动
专区
圈层
工具
发布
49 篇文章
1
《纸上谈兵·solidity》第 0 课:搭建 Solidity 开发环境(三种方式)
2
《纸上谈兵·solidity》第 1 课:部署你的第一个 Solidity 合约
3
《纸上谈兵·solidity》第 2 课:调用、修改、读取,Solidity 合约不是 REST API
4
《纸上谈兵·solidity》第 3 课:事件(Event)机制与链上日志——不是 print,是广播!
5
《纸上谈兵·solidity》第 4 课:Solidity 合约中的错误处理机制(`require`、`revert`、`assert`)和自定义错误
6
《纸上谈兵·solidity》第 5 课:依赖与外部调用 —— 合约交互的风险与防护
7
《纸上谈兵·solidity》第 6 课:Solidity 数据存储布局 —— memory、storage、calldata 傻傻分不清?
8
《纸上谈兵·solidity》第 7 课:Solidity 函数可见性和修饰器 —— public 和 private 不只是权限标签
9
《纸上谈兵·solidity》第 8 课:Solidity 中的继承与接口 —— 模块化不是“复制粘贴”的借口
10
《纸上谈兵·solidity》第 9 课:Solidity 事件与日志机制 —— 合约世界的“printf”工具
11
《纸上谈兵·solidity》第 10 课:Solidity `fallback` / `receive` 函数 —— 合约如何收 ETH 和响应未知调用?
12
《纸上谈兵·solidity》第 11 课:Solidity 错误处理与异常机制 —— 让合约优雅地失败
13
《纸上谈兵·solidity》第 12 课:Solidity 函数选择器与 ABI 编码原理
14
《纸上谈兵·solidity》第 13 课:Solidity 低级调用 call/delegatecall/staticcall —— 直接和 EVM“对话”
15
《纸上谈兵·solidity》第 14 课:Solidity 中的可升级合约模式 —— 从代理合约到透明代理、UUPS 与安全陷阱
16
《纸上谈兵·solidity》第 15 课:Solidity 库与可重用代码
17
《纸上谈兵·solidity》第 16 课:Pull over Push 支付模式与 Check-Effects-Interactions 原则
18
《纸上谈兵·solidity》第 17 课:合约设计模式实战(二)—— Access Control 与权限管理
19
《纸上谈兵·solidity》第 18 课:合约设计模式实战(三)—— 代理 + 插件化架构(Diamond Standard / EIP-2535)
20
《纸上谈兵·solidity》第 19 课:安全专题(一)—— 常见攻击手法与防御
21
《纸上谈兵·solidity》第 20 课:Solidity 安全专题(二)—— 编译器特性与低级漏洞
22
《纸上谈兵·solidity》第 21 课:Gas 优化与成本分析 —— 写出便宜的智能合约
23
《纸上谈兵·solidity》第 22 课:代币合约(ERC20)从零实现与扩展
24
《纸上谈兵·solidity》第 23 课:NFT 合约(ERC721 / ERC1155)实战
25
《纸上谈兵·solidity》第 24 课:去中心化众筹合约(Crowdfunding)实战
26
《纸上谈兵·solidity》第 25 课:简化版的去中心化交易所(DEX)简化版
27
《纸上谈兵·solidity》第 26 课:借贷合约简化实现
28
《纸上谈兵·solidity》第 27 课:DAO 治理合约(去中心化自治组织)
29
《纸上谈兵·solidity》第 28 课:智能合约安全审计案例复盘 -- The DAO Hack(2016)
30
《纸上谈兵·solidity》第 29 课:智能合约安全审计案例复盘 -- Parity Wallet Hack(2017)
31
《纸上谈兵·solidity》第 30 课:智能合约安全审计案例复盘 -- Nomad Bridge(2022)
32
《纸上谈兵·solidity》第 31 课:多签钱包在跨链桥中的应用 —— Nomad 事件复盘
33
《纸上谈兵·solidity》第 32 课:DeFi 基础合约
34
《纸上谈兵·solidity》第 33 课:多签钱包(Multisig Wallet)-- 合约设计与实现
35
《纸上谈兵·solidity》第 34 课:多签钱包(Multisig Wallet)-- 上线
36
《纸上谈兵·solidity》第 35 课:去中心化交易所(DEX)实战 — 合约设计
37
《纸上谈兵·solidity》第 36 课:去中心化交易所(DEX)实战 — 上线
38
《纸上谈兵·solidity》第 37 课:DeFi 实战 -- 资金池与利率模型
39
《纸上谈兵·solidity》第 38 课:DeFi 实战(2) -- 清算机制与价格预言机
40
《纸上谈兵·solidity》第 39 课:DeFi 实战(3) -- 利息累积与 aToken 设计
41
《纸上谈兵·solidity》第 40 课:DeFi 实战(4) -- 风险控制与防护
42
《纸上谈兵·solidity》第 41 课:DeFi 实战(5) -- 协议费与治理
43
《纸上谈兵·solidity》第 42 课:DeFi 实战(6) -- 跨资产借贷与多市场支持
44
《纸上谈兵·solidity》第 43 课:DeFi 实战(7) -- 清算机制进阶(多资产抵押清算路径、拍卖机制)
45
《纸上谈兵·solidity》第 44 课:DeFi 实战(8) -- 利率曲线与资金池优化(动态利用率模型)
46
《纸上谈兵·solidity》第 45 课:DeFi 实战(9) -- 利息累积与结算机制(可复利)
47
《纸上谈兵·solidity》第 46 课:DeFi 实战(10) -- 跨链借贷与流动性桥接
48
《纸上谈兵·solidity》第 47 课:DeFi 实战(11) -- 治理代币 & 激励机制(Tokenomics & Governance)
49
《纸上谈兵·solidity》第 48 课:DeFi 实战(12) -- 前端 DApp 集成与用户交互(React + ethers.js 实战)

《纸上谈兵·solidity》第 4 课:Solidity 合约中的错误处理机制(`require`、`revert`、`assert`)和自定义错误

在智能合约的开发过程中,错误处理 是确保系统健壮性、安全性和可预测行为的关键环节。本课我们将深入探讨 Solidity 中三种主要的错误处理机制:

  • require: 外部输入校验与逻辑前置判断
  • revert: 复杂条件下的显式失败
  • assert: 关键不变量的保护(程序性保证)
  • 自定义错误:为更经济的 Gas 使用和更清晰的调试而生

一、为什么错误处理如此重要?

区块链是不可逆的执行环境,一旦执行逻辑失败或出现异常,状态必须 完全回滚,以防止资金损失或系统进入不可恢复状态。Solidity 的错误处理机制允许我们:

  • 终止交易执行
  • 返回原因字符串或结构化错误
  • 节省 Gas(在失败时停止执行)
  • 保持系统状态一致性
  • 帮助调试和单元测试

举例:如果用户尝试从余额为 0 的账户中取款,我们应在逻辑层立即中止执行,而不是继续走到更底层逻辑。


二、require:外部输入与状态条件的守门人

语法

代码语言:txt
复制
require(condition, "Failure message");
  • 通常用于验证函数输入参数、权限控制、账户余额等外部依赖条件
  • 如果 conditionfalse,自动 revert,并附带错误消息

场景举例

代码语言:txt
复制
function deposit(uint amount) public {
    require(amount > 0, "Deposit amount must be greater than zero");
    balance[msg.sender] += amount;
}

实践要点

  • 清晰明了的消息有助于前端显示或调试
  • 用于检测 “可预期的失败”,例如用户输入非法参数、合约状态不符合操作要求

三、revert:更灵活的显式失败语句

语法

代码语言:txt
复制
if (conditionFails) {
    revert("Reason for failure");
}
  • require 类似,都会 回滚状态并退还 Gas(未消耗部分)
  • 优势是允许我们先执行多步逻辑或嵌套判断,然后再统一失败处理

示例

代码语言:txt
复制
function withdraw(uint amount) public {
    if (amount > balance[msg.sender]) {
        revert("Insufficient balance");
    }
    balance[msg.sender] -= amount;
}

进阶用法

代码语言:txt
复制
function executeTrade(address user, uint amount) public {
    if (!isWhitelisted(user)) {
        revert("User not whitelisted");
    }
    if (amount < minTradeSize) {
        revert("Trade amount too small");
    }
    // proceed with trade
}

四、assert:防御性编程的最后防线

语法

代码语言:txt
复制
assert(condition);
  • 不返回错误字符串,失败时触发 Panic(uint256) 错误(错误码如 0x01 表示断言失败)
  • 用于测试不可变条件、不变量或内部错误
  • 永远不应该被用户输入触发,否则说明合约存在重大逻辑漏洞

示例

代码语言:txt
复制
function increment() public {
    count += 1;
    assert(count > 0); // 这个永远应该成立
}

常见场景

  • 检查数组索引越界
  • 验证状态机状态不可能出错
  • Solidity 0.8+ 版本中,很多算术溢出已内建 assert-like 检查(除非 unchecked

五、自定义错误(Custom Errors)

Solidity 0.8.4 起引入了自定义错误机制:

语法

代码语言:txt
复制
error NotEnoughBalance(uint256 requested, uint256 available);

function withdraw(uint amount) public {
    if (amount > balance[msg.sender]) {
        revert NotEnoughBalance(amount, balance[msg.sender]);
    }
}

优点

String 失败

自定义错误

Gas 成本

高(每个字符都编码)

低(只编码数据)

可读性

可结构化分析

不行

可以(可被前端或脚本解析)

多错误例子

代码语言:txt
复制
error Unauthorized(address caller);
error InvalidAmount(uint256 amount);

function transferOwnership(address newOwner) public {
    if (msg.sender != owner) revert Unauthorized(msg.sender);
    if (newOwner == address(0)) revert InvalidAmount(0);
    owner = newOwner;
}

六、使用机制选择指南

场景

使用机制

推荐理由

基础参数验证

require

简洁明确,附带错误消息

多条件判断或嵌套逻辑

revert

可读性好,适合逻辑封装

内部程序断言

assert

表示不可被破坏的程序性不变量

节约 Gas + 可调试

error + revert

结构清晰,适合高复杂度和可读性设计


七、实战练习(基于foundry)

合约我们还是以 Counter 为例,在这次的实验中,我们将使用 requirerevert 来对 count 进行限制,确保它小于 10,以及使用 assert 来防止内部状态错误:

代码语言:txt
复制
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract Counter {
    uint256 public count;

    // 添加事件
    event Incremented(uint256 newCount);


    function increment() public {
        count += 1;
        
        // 触发事件
        emit Incremented(count);
    }

    function getCount() public view returns (uint256) {
        return count;
    }

    function whoAmI() public view returns (address) {
        return msg.sender;
    }
}

练习题 1:限制 count 不能超过 10

代码语言:txt
复制
function incrementRequire() public {
    require(count < 10, "Counter overflow");
    count += 1;
}

练习题 2:改用 Custom Error

代码语言:txt
复制
error CounterOverflow(uint current);

function incrementRevert() public {
    if (count >= 10) {
        revert CounterOverflow(count);
    }
    count += 1;
}

练习题 3:尝试使用 assert 来检测内部异常

代码语言:txt
复制
function decrement() public {
    count -= 1;
    assert(count >= 0); // uint 永远不能 < 0,会 Panic
}

编译时不会报错,但运行时可能触发 Panic(0x11) 错误。推荐加 require 防御性判断替代。


测试合约

代码语言:txt
复制
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import "forge-std/Test.sol";
import "../src/Counter.sol";

contract CounterTest is Test {
    Counter counter;

    function setUp() public {
        counter = new Counter();
    }

    function testInitialCountIsZero() view public {
        uint256 c = counter.getCount();
        assertEq(c, 0);
    }

    function testIncrementIncreasesCount() public {
        counter.increment();
        uint256 c = counter.getCount();
        assertEq(c, 1);
    }

    // 测试事件是否正确触发
    function testIncrementEmitsEvent() public {
        // 设定期望的事件参数(按顺序匹配)
        vm.expectEmit(false, false, false, true); // 只检查数据,不检查 topics(因为 uint256 不能 indexed)
        emit Counter.Incremented(1);

        counter.increment();
    }

        function testIncrementRequireSuccess() public {
        for (uint i = 0; i < 10; i++) {
            counter.incrementRequire();
        }
    }

    function testIncrementRequireFail() public {
        for (uint i = 0; i < 10; i++) {
            counter.incrementRequire();
        }
        vm.expectRevert("Counter overflow");
        counter.incrementRequire();
    }

    function testIncrementRevertCustomError() public {
        for (uint i = 0; i < 10; i++) {
            counter.incrementRevert();
        }
        vm.expectRevert(abi.encodeWithSelector(Counter.CounterOverflow.selector, 10));
        counter.incrementRevert();
    }

    function testDecrementPanics() public {
        vm.expectRevert(); // expect a panic due to underflow
        counter.decrement();
    }

    function testDecrementAfterIncrement() public {
        counter.increment();
        counter.decrement();
        assertEq(counter.getCount(), 0);
    }
}
forge test

最佳实践总结

  • 用户可控参数 → 使用 require
  • 复杂业务分支 → 使用 revert
  • 永远不应该发生的情况 → 使用 assert
  • 节省 Gas 且结构清晰 → 使用自定义错误
下一篇
举报
领券