Web3.js调用getBalance获取账户余额报地址无效错误如何解决

报错根因 #

你使用的Web3.js v1.5.3属于1.x版本分支，该版本中web3.eth.accounts不再是同步返回账户列表的属性，直接调用web3.eth.accounts[0]会得到undefined值，传入getBalance方法就会触发地址无效的报错。

排查步骤 #

• 先打印web3.eth.accounts确认返回值，正常情况下1.x版本该属性不会直接返回账户数组
• 验证你连接的节点（Ganache/Truffle开发节点/公链节点）是否正常运行，节点内是否已配置可用账户
• 核对truffle-config.js中的网络配置，确认网络端口、链ID等参数和当前运行的节点匹配

正确实现代码 #

Web3.js 1.x所有链上交互API均为异步Promise格式，需要用async/await或回调函数处理返回结果：

推荐写法（async/await） #

// 先异步获取账户列表
const accounts = await web3.eth.getAccounts();
// 获取对应地址余额
const balance = await web3.eth.getBalance(accounts[0]);
// 转换为ether单位
const etherBalance = web3.utils.fromWei(balance, "ether");
console.log(Number(etherBalance));

回调写法 #

web3.eth.getAccounts((error, accounts) => {
  if (error) throw error;
  web3.eth.getBalance(accounts[0], (error, balance) => {
    if (error) throw error;
    const etherBalance = web3.utils.fromWei(balance, "ether");
    console.log(Number(etherBalance));
  });
});

Truffle脚本/控制台专用写法 #

如果是在Truffle控制台或者Truffle测试脚本中运行，可以直接使用上下文中注入的accounts参数：

contract("测试合约", accounts => {
  const ownerBalance = Number(web3.utils.fromWei(await web3.eth.getBalance(accounts[0]), "ether"));
  console.log(ownerBalance);
})

补充注意事项 #

• Web3.js 1.x中单位转换API已迁移到web3.utils命名空间下，推荐优先使用web3.utils.fromWei替代旧版web3.fromWei
• 若调用web3.eth.getAccounts返回空数组，需要确认节点已开启账户相关RPC权限，且账户已经导入节点中

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