Hardhat控制台中connect方法无法正常使用的原因排查

核心原因 #

Hardhat控制台与单元测试环境的合约实例运行器（runner）机制存在差异：

• 单元测试中，你使用的账户通常是通过ethers.getSigners()获取的Signer对象，这类对象内置签名与交易发送能力，传给connect()后能正常调用合约方法。
• 控制台中如果直接将纯地址字符串传给connect()，ethers.js会生成一个无签名能力的静态地址实例，仅支持只读的静态调用（call），无法处理需要发送交易的合约方法，因此抛出contract runner does not support calling错误。

解决步骤 #

在控制台中按以下流程操作即可：

1. 先获取目标账户对应的Signer对象：

const signer = await ethers.getSigner("0x47D20A3Fb51C6Cf3aB847136bC6CedBf86c8BD58");

2. 使用该Signer对象切换合约实例的调用者：

const connectedContract = contract.connect(signer);

3. 正常调用合约方法：

await connectedContract.yourContractMethod();

额外说明 #

如果你的合约方法是只读类型（view/pure修饰），直接传地址给connect()也能执行静态调用，但涉及交易写入的方法必须使用带签名能力的Signer对象。测试环境中Hardhat会自动为测试账户注入Signer能力，因此无需额外处理。

内容的提问来源于stack exchange，提问作者Joey Yi Zhao