Ethers.js v6调用合约函数报错：contract runner does not support calling

核心问题 #

Ethers v6里，合约实例的**runner（执行器）**决定了它能执行的操作：

• 用Provider创建的合约实例只能处理只读操作（比如查询余额这种不修改链上数据的操作）
• 要调用修改链上状态的合约函数，必须用Signer（带有用户签名权限的执行器）作为runner

你查询余额正常但调用函数报错，大概率是创建合约实例时用了Provider而非Signer。

修复方法 #

1. 用Signer创建可写合约实例 #

连接钱包后，从Provider中获取Signer，再用它初始化合约：

import { ethers } from "ethers";

async function connectAndCallContract() {
  if (!window.ethereum) return alert("请安装MetaMask");
  
  const provider = new ethers.BrowserProvider(window.ethereum);
  await provider.send("eth_requestAccounts", []);
  const signer = await provider.getSigner();
  
  // 关键：用signer代替provider创建合约实例
  const contract = new ethers.Contract(CONTRACT_ADDR, CONTRACT_ABI, signer);
  
  // 现在调用函数就不会报错了
  try {
    const tx = await contract.yourContractFunction();
    await tx.wait();
    console.log("交易成功");
  } catch (err) {
    console.error("交易失败", err);
  }
}

2. 分开管理只读/可写合约实例 #

如果需要同时处理查询和写操作，可以创建两个实例各司其职：

const provider = new ethers.BrowserProvider(window.ethereum);
// 只读实例，用于查询数据
const readOnlyContract = new ethers.Contract(CONTRACT_ADDR, CONTRACT_ABI, provider);
// 获取签名者
const signer = await provider.getSigner();
// 可写实例，用于执行修改链上状态的操作
const writeContract = new ethers.Contract(CONTRACT_ADDR, CONTRACT_ABI, signer);

// 执行只读操作（查询余额）
const balance = await readOnlyContract.getBalance();
// 执行写操作（比如存币）
const tx = await writeContract.deposit({ value: ethers.parseEther("0.01") });
await tx.wait();

3. 检查Solidity函数类型 #

确认你调用的函数不是pure或view（这两类是只读函数），如果是public/external的写函数，必须通过Signer执行。

v5与v6的写法差异提醒 #

教程用的Ethers v5中，是通过contract.connect(signer)切换执行器；v6里要么直接用Signer创建合约实例，要么通过readOnlyContract.connect(signer)生成可写实例，逻辑一致但写法更直接。

内容的提问来源于stack exchange，提问作者m-dango