新版Web3.js如何创建智能合约实例并调用合约函数？

核心差异说明 #

旧教程里的.at()方法是早期web3.js 0.x版本搭配Truffle合约抽象层的专属API，web3.js 1.0及之后的稳定版本（含当前主流的v2.x、v4.x）已经完全废弃该写法，直接使用web3原生合约对象即可完成实例化，不需要额外依赖Truffle封装。

前置校验 #

开始操作前先确认3个必要条件满足：

• 已拿到编译输出的完整合约ABI数组（即你提取的contractABI变量，注意不要取编译结果的嵌套层级，直接拿abi字段对应的数组即可）
• 已拿到合约部署后的有效链上地址（即Ganache中合约创建交易记录里的合约地址，对应你打印的greetingsDeployed.address）
• web3实例已正常连通7545端口的Ganache节点，可执行await web3.eth.getAccounts()正常返回测试账户列表验证连接

正确实例化写法 #

分两种场景对应不同写法：

场景1：部署流程内直接获取可用实例 #

如果是在同一段脚本里完成部署后立刻调用合约，部署交易成功返回的对象本身就是绑定好地址的可用实例，不需要额外执行实例化操作，参考完整部署代码：

const fs = require('fs');
const solc = require('solc');
const Web3 = require('web3');
// 连接Ganache
const web3 = new Web3('http://127.0.0.1:7545');

// 1. 读取、编译合约（你已经完成的步骤）
const source = fs.readFileSync('Greetings.sol', 'utf8');
const input = {
  language: 'Solidity',
  sources: { 'Greetings.sol': { content: source } },
  settings: { outputSelection: { '*': { '*': ['abi', 'evm.bytecode'] } } }
};
const compiled = JSON.parse(solc.compile(JSON.stringify(input)));
const contractABI = compiled.contracts['Greetings.sol']['Greetings'].abi;
const bytecode = compiled.contracts['Greetings.sol']['Greetings'].evm.bytecode.object;

// 2. 初始化合约对象、发部署交易
const deployerAccount = (await web3.eth.getAccounts())[0];
const greetingsContract = new web3.eth.Contract(contractABI);
const greetingsInstance = await greetingsContract.deploy({
  data: bytecode.startsWith('0x') ? bytecode : '0x' + bytecode,
  arguments: [] // 合约构造函数有入参的话在这里传，无参就留空数组
}).send({
  from: deployerAccount,
  gas: 1500000
});
// 这里拿到的greetingsInstance就是可直接调用方法的实例，等价于旧版.at()的返回值
console.log('合约部署地址:', greetingsInstance.options.address);

场景2：已知合约地址重新初始化实例 #

如果是重启脚本、连接已经部署到链上的合约，初始化合约对象时直接传入地址作为第二个参数即可：

// 替换为你实际的已部署合约地址
const deployedAddress = greetingsDeployed.address;
const greetingsInstance = new web3.eth.Contract(contractABI, deployedAddress);

合约方法调用示例 #

Greetings.sol中的两类方法对应不同调用方式：

• 对于getGreetings这类view/pure修饰的读方法，用.call()调用，不需要发交易、不消耗Gas，直接返回链上存储的数据：

const storedGreeting = await greetingsInstance.methods.getGreetings().call();
console.log('当前链上存储的问候内容:', storedGreeting);

• 对于setGreetings这类修改链上状态的写方法，用.send()发送交易，需要指定签名账户、消耗Gas：

const deployerAccount = (await web3.eth.getAccounts())[0];
const txReceipt = await greetingsInstance.methods.setGreetings('Hello Web3').send({
  from: deployerAccount,
  gas: 200000
});
console.log('修改操作已上链,交易哈希:', txReceipt.transactionHash);
// 交易确认后再调用getGreetings即可拿到更新后的值

常见踩坑提示 #

• solc版本必须和Greetings.sol开头声明的pragma solidity版本严格匹配，否则编译出的ABI会存在方法缺失、参数错误问题
• 部署时传入的字节码必须带0x前缀，否则会报无效数据错误
• 调用写方法时必须传入from参数指定签名账户，否则web3无法正常发送交易
• 目前主流web3.js v2.x、v4.x版本对上述写法完全兼容，不需要额外调整参数

内容的提问来源于stack exchange，提问作者verpas