web3 前端常见错误类型以及错误捕获处理

在Web3前端开发中，常见的错误类型包括用户拒绝交易、RPC节点超时、网络连接问题、智能合约调用错误等。正确捕获这些错误并提供友好的用户提示是提升用户体验的关键。以下是一些常见的Web3前端错误类型及其处理方法：

1. 用户拒绝交易

根据错误码 4001 用户拒绝进行判断并进行提示。

try {
  const tx = await contract.someFunction();
} catch (error) {
  if (error.code === 4001) {
    // 用户拒绝了交易
    alert('用户拒绝了交易。');
  } else {
    console.error('交易失败:', error);
    alert('交易失败，请稍后再试。');
  }
}

2. RPC 节点超时

与RPC节点的连接超时或节点响应过慢。

try {
  const provider = new ethers.providers.JsonRpcProvider('https://mainnet.infura.io/v3/YOUR_PROJECT_ID');
  const contract = new ethers.Contract(contractAddress, contractABI, provider);
  const result = await contract.someFunction();
} catch (error) {
  if (error.message.includes('timeout')) {
    alert('RPC节点超时，请稍后再试。');
  } else {
    console.error('RPC节点错误:', error);
    alert('RPC节点错误，请稍后再试。');
  }
}

3. 网络连接问题

用户未连接到钱包或网络连接不稳定，错误码 -32601。

try {
  const accounts = await window.ethereum.request({ method: 'eth_requestAccounts' });
} catch (error) {
  if (error.code === -32601) {
    alert('请连接到MetaMask钱包。');
  } else {
    console.error('网络连接错误:', error);
    alert('网络连接错误，请检查您的钱包设置。');
  }
}

4. 智能合约调用错误

调用智能合约时发生错误，例如调用不存在的函数或参数错误。

try {
  const tx = await contract.nonExistentFunction();
} catch (error) {
  if (error.message.includes('invalid opcode')) {
    alert('智能合约调用失败，请检查输入参数。');
  } else {
    console.error('智能合约调用错误:', error);
    alert('智能合约调用失败，请稍后再试。');
  }
}

5. 交易打包失败

交易被打包失败，可能是由于Gas不足、交易被拒绝等原因。

try {
  const tx = await contract.someFunction();
  const receipt = await tx.wait();
} catch (error) {
  if (error.message.includes('transaction failed')) {
    alert('交易被打包失败，请检查Gas设置或交易参数。');
  } else {
    console.error('交易失败:', error);
    alert('交易失败，请稍后再试。');
  }
}

6. 链ID不匹配

用户连接的链ID与目标链ID不匹配。

try {
  const chainId = await window.ethereum.request({ method: 'eth_chainId' });
  if (chainId !== '0x1') { // 假设目标链ID是主网（0x1）
    alert('请切换到以太坊主网。');
  }
} catch (error) {
  console.error('链ID检测失败:', error);
  alert('链ID检测失败，请检查您的钱包设置。');
}

7. 交易未确认

交易发送后未被矿工确认。

try {
  const tx = await contract.someFunction();
  const receipt = await tx.wait();
} catch (error) {
  if (error.message.includes('transaction not confirmed')) {
    alert('交易未确认，请稍后再试。');
  } else {
    console.error('交易失败:', error);
    alert('交易失败，请稍后再试。');
  }
}

8. Gas 费用过高

用户拒绝支付过高的Gas费用。

try {
  const tx = await contract.someFunction();
} catch (error) {
  if (error.message.includes('gas price too high')) {
    alert('Gas费用过高，请调整Gas设置。');
  } else {
    console.error('交易失败:', error);
    alert('交易失败，请稍后再试。');
  }
}

9. 用户未安装钱包

if (!window.ethereum) {
  alert('请安装MetaMask扩展程序。');
} else {
  try {
    const accounts = await window.ethereum.request({ method: 'eth_requestAccounts' });
  } catch (error) {
    console.error('连接钱包失败:', error);
    alert('连接钱包失败，请检查MetaMask设置。');
  }
}