智能合约与以太坊 / 系统课时

通过构造函数设置初始状态

通过构造函数设置初始状态

部署智能合约时,往往需要立即确定管理者、初始数值和业务限制。本课使用带参数的 constructor 初始化 Counter 合约,让 owner 和计数上限在部署后保持不变,同时让计数值保存在可修改的链上状态中,并通过 Remix 验证初始化结果与权限约束。

学习目标

  • 编写带参数的 constructor,在部署阶段完成状态初始化和参数校验。
  • 区分 immutable 变量与普通状态变量的存储方式和修改规则。
  • 使用 Remix 传入构造参数,验证部署结果、状态持久化和错误边界。

构造函数何时执行

constructor 是 Solidity 的特殊函数,只在创建合约实例时执行一次。部署交易携带创建字节码和经过 ABI 编码的构造参数,EVM 执行创建代码,完成状态初始化;成功后保存合约的运行时字节码。构造函数本身不会作为可调用函数保留在部署后的运行时代码中。

构造函数可以接收参数,但没有普通函数那样的 public 或 external 可见性修饰符。一个合约最多只能声明一个构造函数,也不能通过不同参数列表重载构造函数。

在计数器场景中,需要初始化三个值:

状态变量 示例初始值 声明方式 部署后能否修改
owner 部署时指定的账户地址 address public immutable 不能
maxCount 5 uint256 public immutable 不能
count 2 uint256 public 可以,通过合约函数修改

immutable 的值可以在构造阶段根据部署参数确定,部署结束后固定在运行时代码中,不占用普通状态变量的存储槽。普通状态变量如 count 则保存在合约存储中,后续成功执行的状态修改会持久化。

constant 与它不同:常量值必须在编译时确定,不能依赖构造函数收到的地址或数值。因此,部署时才能确定的管理者地址适合使用 immutable。

编写带初始化参数的 Counter

创建 Counter.sol,使用 Solidity 0.8.24 或兼容的后续 0.8.x 编译器。下面的完整合约允许部署者指定管理者、初始计数和计数上限,并限制只有管理者能够递增计数。

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

contract Counter {
    address public immutable owner;
    uint256 public immutable maxCount;
    uint256 public count;

    error InvalidOwner();
    error InvalidRange();
    error NotOwner();
    error CountAtLimit();

    constructor(
        address initialOwner,
        uint256 initialCount,
        uint256 initialMaxCount
    ) {
        // 拒绝无效管理者和不合理的初始计数范围
        if (initialOwner == address(0)) revert InvalidOwner();
        if (initialMaxCount == 0 || initialCount > initialMaxCount) {
            revert InvalidRange();
        }

        // immutable 值在创建阶段确定,普通状态写入合约存储
        owner = initialOwner;
        maxCount = initialMaxCount;
        count = initialCount;
    }

    function increment() external {
        // 运行时检查调用者与不可变的计数上限
        if (msg.sender != owner) revert NotOwner();
        if (count >= maxCount) revert CountAtLimit();

        count += 1;
    }
}

预期结果:使用匹配的 Solidity 编译器可以成功编译,生成包含 owner()、maxCount()、count() 和 increment() 的合约接口。编译不会创建链上实例,三个初始值要等实际部署时才能确定。

这里有三个值得检查的细节。

首先,initialOwner 是调用者提供的地址,而不是自动使用 msg.sender。如果通过工厂合约部署,构造函数中的 msg.sender 通常是工厂合约地址,未必是预期的管理账户。显式传入地址可以避免把工厂误设为管理者,但部署调用方也必须核对这个地址是否正确。

其次,构造函数必须先验证参数,再完成初始化。当 initialMaxCount 为 0 或 initialCount 大于上限时,交易会回退,不会留下成功部署的合约实例。

最后,increment() 是运行时函数。它使用不可变的 owner 和 maxCount 执行校验,但只修改普通状态变量 count。这种设计适合管理者和业务上限部署后不再变化的场景。

理解部署参数如何变成链上状态

创建阶段和运行阶段使用的数据位置不同。构造函数中的参数是创建过程的输入,owner 与 maxCount 的最终值进入运行时字节码中的不可变数据位置,而 count 的数值保存在合约存储中。

Counter 构造参数初始化、运行时代码与链上存储的数据流

可以用两个动作验证这种区别:部署时设置 count=2,随后调用 increment() 使它变为 3;但无论调用多少次 increment(),owner 和 maxCount 都保持原值。

需要注意,部署后重新执行构造函数并不是修改状态的方法。如果希望管理者可移交,应该单独设计带权限校验的管理者变更机制,并将对应状态改为可修改的存储变量,而不是继续使用 immutable。

在 Remix 中部署并检查结果

使用 Remix IDE 的浏览器内虚拟链即可完成实验,无须测试网 ETH,也不需要配置外部钱包。操作顺序如下。

  1. 打开 Remix IDE,在 File Explorer 中新建 Counter.sol,粘贴上面的完整代码。
  2. 打开 Solidity Compiler,选择支持 ^0.8.24 的 0.8.x 编译器,点击 Compile Counter.sol。确认没有编译错误。
  3. 进入 Deploy & Run Transactions,在 Environment 中选择 Remix VM 环境,在 Account 中选定一个测试账户,并复制显示的账户地址。不同 Remix 版本可能提供不同硬分叉名称的 Remix VM。
  4. 确认 Value 为 0,Contract 选择 Counter。按构造参数顺序填写 initialOwner 为刚复制的账户地址、initialCount 为 2、initialMaxCount 为 5。
  5. 点击 Deploy。成功后,在 Deployed Contracts 中展开新创建的 Counter 实例。

部署参数使用实际账户地址,而不是示例中的固定地址。Remix VM 重置或切换环境后,账户与部署地址可能发生变化。

调用三个自动生成的读取函数,预期结果如下:

读取函数 预期结果
owner() 与部署时传入的账户地址一致
maxCount() 5
count() 2

然后保持当前 Account 为部署时指定的管理账户,调用一次 increment()。预期结果是交易成功,再调用 count() 返回 3。

继续调用两次,count() 依次返回 4 和 5。此时再调用一次 increment(),交易会因 CountAtLimit() 自定义错误而回退,count() 仍返回 5。

如果把 Account 切换为另一个 Remix VM 账户,再调用 increment(),预期交易因 NotOwner() 回退。具体交易哈希、Gas 消耗和账户地址由当前虚拟链环境决定,不应与其他人的运行结果逐字比较。

检查无效参数和初始化边界

构造函数校验失败时,整个创建交易会回退。这不仅阻止错误值写入状态,也意味着该次部署没有成功产生可使用的合约实例。

可以在 Remix 中重新填写参数,分别测试以下三组情况:

构造参数条件 预期结果 原因
initialOwner 为零地址 部署回退,InvalidOwner() 不允许没有有效管理者的实例
initialCount=6,initialMaxCount=5 部署回退,InvalidRange() 初始值超过上限
initialCount=0,initialMaxCount=5 部署成功 初始值为零是合法状态

如果部署失败,应先查看 Remix 交易详情中的回退信息,再核对构造参数的顺序、类型和值。特别要注意:initialOwner 必须是完整有效的 Ethereum 地址,initialCount 和 initialMaxCount 是无符号整数,不能输入负数。

实际项目还需要明确管理者是否允许轮换、上限是否允许调整,以及部署交易是否可能通过工厂执行。如果这些规则要求部署后发生变化,就不应把相应字段定义为 immutable。对于本例固定管理者和固定上限的需求,构造函数负责一次性初始化,increment() 负责后续受权限约束的持久化状态修改。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

通过构造函数设置初始状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通