mats软件错误代码

MetaMask 使我们能够访问去中心化应用程序 (dApp)，同时使用 MetaMask 钱包提供一种身份验证形式。它提供一键式安全登录流程，允许我们在前端使用以太币访问区块链资源。[1]MetaMask 抽象出微妙的过程，例如在与区块链交互时签署交易，并将您的 MetaMask 的公共地址提供给应用程序。

因此，作为开发者，在构建这些dApps时，难免会出现错误，而这些错误应该得到妥善处理，让开发者和用户都知道哪里出了问题。由于 MetaMask 文档没有针对使用 MetaMask 时可能出现的多种错误的全面而清晰的指南，因此我在此处编制了一份最常见错误及其含义的列表。

4001

当尝试连接到钱包时，如果用户在此界面上的任意位置单击“取消”并终止该过程，则会返回4001错误。

这是错误的 JSON 结构：

'4001': { standard: 'EIP-1193', message: 'User rejected the request.',},

4100

例如，要执行某些操作（如签名消息），您需要先使用以下eth_requestAccounts方法从 MetaMask 获得帐户权限：

import { ethers } from "ethers";const accounts = await ethereum.request({ method: "eth_requestAccounts",});const address = accounts[0];const provider = new ethers.providers.Web3Provider(ethereum);const signer = provider.getSigner();const signature = await signer.signMessage(address);console.log(signer);

同样，要切换你的钱包链，你需要使用该wallet_switchEthereumChain方法，该方法依次通过 MetaMask 扩展程序请求权限：

// switching the chain for MetaMask walletawait provider.request({ method: "wallet_switchEthereumChain", params: [{ chainId: "0x89" }],});

如果权限被拒绝，钱包将返回此错误：

'4100': { standard: 'EIP-1193', message: 'The requested account and/or method has not been authorized by the user.',},

4200

MetaMask 启用两种方法：受限和不受限。这些方法允许 dApp 执行连接到钱包、签署交易以及添加或切换网络等操作。

MetaMask 不支持的方法会返回此错误：

'4200': { standard: 'EIP-1193', message: 'The requested method is not supported by this Ethereum provider.',},

您可以在此处找到指向现有方法的链接[2]。

4900

当用户的 MetaMask 钱包未连接任何链时返回此错误：

ethereum.on('disconnect', (error) => console.log(error));

这与disconnect事件有关。当钱包断开连接并且无法向链提交请求时会触发此事件。除了断开连接，这也可能由于网络连接问题而发生。

一旦我们发出disconnect，提供者将不会接受任何新的请求，直到重新建立与链的连接，这需要重新加载页面。您还可以使用ethereum.isConnected() 方法[3]来确定提供程序是否已断开连接。

这是错误的 JSON 响应：

'4900': { standard: 'EIP-1193', message: 'The provider is disconnected from all chains.',},

4901

此错误意味着用户未连接到该交易的适当链。例如，如果交易要求用户在 Polygon 链上，而他们在Harmony 或以太坊区块[4]链上。

需要注意的一件事是，MetaMask 提供程序允许我们监听chainChanged事件，如果当前连接的链发生变化，该事件将监听并采取行动：

ethereum.on('chainChanged', (chainId) => {console.log(chainId)});

我们将 RPC 请求提交[5]给当前连接的链，这使得通过监听变化来跟踪当前链 ID 变得很重要。每条链都有其唯一的 chainID，您可以在Chainlist 上找到它。[6]

如果它无法向该特定链提交 RPC 请求，它会返回错误：

'4901': { standard: 'EIP-1193', message: 'The provider is disconnected from the specified chain.',}

32700

如果用户向合约发送不完整的请求对象，则会返回此错误。如果发送给合约的对象不包含它需要的所有数据，就会发生这种情况。

这是 JSON 响应：

'-32700': { standard: 'JSON RPC 2.0', message: 'Invalid JSON was received by the server. An error occurred on the server while parsing the JSON text.', },

32600

此处，对象有效，但结构或属性不正确。它有点类似于 32700，但在这种情况下，它的内部结构不正确。

这是 JSON 响应：

'-32600': { standard: 'JSON RPC 2.0', message: 'The JSON sent is not a valid Request object.', },

32601

如果指定的方法根本不存在，则返回此错误：

'-32601': { standard: 'JSON RPC 2.0', message: 'The method does not exist / is not available.', },

您可以在此处找到指向现有方法的链接[7]。

32602

如果传递给RPC 方法[8]的参数不正确，我们会收到此错误。例如，在定义transactionParameters 时，from属性引用accounts[0]。

通常，accounts[0]应该是用户的钱包地址，但在这种情况下，我们将其分配给一个空数组：

let accounts = []; const amountEth = 1 const paymentAddress = '0x71C7656EC7ab88b098defB751B7401B5f6d8976F' const transactiOnParameters= { from: accounts[0], to: paymentAddress, value: web3.toWei(amountEth, 'ether') }; function Mint(){ ethereum.request({ method: 'eth_sendTransaction', params: [transactionParameters] }); }

该Mint函数将返回此特定错误，因为参数显然无效：

'-32602': { standard: 'JSON RPC 2.0', message: 'Invalid method parameter(s).', },

32603

这是由几件事引起的一揽子错误。这可能是因为您正在尝试向您的钱包添加一条新链（手动或通过 dApp）但添加了错误的链数据。或者，你正试图完成一笔交易，但你没有足够的代币来支付 gas 费。例如，如果您在以太坊主网上进行交易，则无论您是否使用其他代币进行交易，都必须以 ETH 支付汽油费。

最后，它可能与没有最新版本的 MetaMask 一样微不足道。

这是错误的 JSON 响应：

'-32603': { standard: 'JSON RPC 2.0', message: 'Internal JSON-RPC error.', },

32000

可能触发此错误的一种情况是，生产中使用的合约地址是您部署到测试网的合约。这是一个我们可以纠正的简单错误。

类似于我们拥有开发环境和生产环境的 Web2，在构建 dApp 时，我们使用测试网部署我们的合约，因此我们可以在构建时测试它，而无需在主网上使用真正的 ETH。因此，部署在测试网和主网上的同一份合约将具有不同的地址。如果您为您所在的链使用了错误的地址，则会返回此错误。

一般来说，在处理智能合约时，你需要像合约地址、ABI 文件和你的签名者这样的参数：

const provider = new ethers.providers.Web3Provider(ethereum);const signer = provider.getSigner();const countCOntract= new ethers.Contract(contractAddress, contractABI, signer);/* * Call the getAllCount method from your Smart Contract */const count = await countContract.getAllCount()

如果这些参数中的任何一个错误，您很可能会得到他的错误，也称为“用户输入错误”：

 '-32000': { standard: 'EIP-1474', message: 'Invalid input.', },

32001

在这种情况下，我们请求的资源在区块链上不存在。这可能是客户端的错字。

想象一下，您正在尝试获取有关 ETH 链上不存在的块号的信息：

import Web3 from 'web3';const web3 = new Web3(web3Provider);var block = await web3.eth.getBlock({invalid block number})

你会得到这个 JSON 响应：

'-32001': { standard: 'EIP-1474', message: 'Resource not found.', },

32002

此错误表示请求的资源确实存在，但在请求时当前不可用。当我们尝试访问当前正在使用的资源时，可能会发生这种情况。当您尝试使用特定资源/方法时，它可能会在 MetaMask 扩展上发生，例如当 MetaMask 当前正在执行相同操作时切换链。

在构建你的 dApp 时，你应该学会在该方法成功启动后禁用你的按钮，这样用户就不会快速连续点击。

这是此错误的 JSON 响应：

'-32002': { standard: 'EIP-1474', message: 'Resource unavailable.', },

32003

这个错误可能是很多事情的结果。可能是因为发件人地址不存在，资金不足，账户被锁定，或者我们无法签署交易。要解决此问题，请确保交易中的所有内容都是正确的。

如果不满足完成交易所需的条件，则可以拒绝交易：

'-32003': { standard: 'EIP-1474', message: 'Transaction rejected.', },

32004

完全不支持该方法。可能它不存在或者只是一个印刷错误：

'-32004': { standard: 'EIP-1474', message: 'Method not supported.', },

32005

此错误表示 RPC 提供程序已超出速率限制。如果 RPC 提供程序终结点对请求数有速率限制，则可能会出现此问题：

'-32005': { standard: 'EIP-1474', message: 'Request limit exceeded.', },

此外，错误消息“intrinsic gas too low”是一个相当常见的错误。这仅仅是因为在启动交易时分配的气体限制小于所需的限制。

这种情况最常发生在交易复杂的情况下，这可能会使汽油费无法预测：

ethereum.request({ method: 'eth_sendTransaction', params: [ { from: accounts[0], to: '0xbCfDCCDbE7B3D681A1144D25a31e0D4BE869079a', value: '0x293434x341af62c0000', gasPrice: '0x09184e242', gas: '0x2709', gasLimit: '0x2723' }, ],}).then((txHash) => console.log(txHash)).catch((error) => console.error);

结论

如果你已经走到最后，恭喜你！我们介绍了一堆可能的错误以及如何处理它们。现在，在构建你的下一个 dApp 时，你可以轻松地解释这些错误并修复它们，而不必对最初导致它们的原因感到困惑。这有助于改善您处理这些 Web3 技术的开发人员体验。

您可以从官方资源[9]中查看有关 MetaMask 错误的更多信息。

引用链接

[1] 以太币访问区块链资源。: https://docs.ethers.io/
[2] 您可以在此处找到指向现有方法的链接: https://docs.metamask.io/guide/rpc-api.html#ethereum-json-rpc-methods
[3] 方法: https://docs.metamask.io/guide/ethereum-provider.html#ethereum-isconnected
[4] Harmony 或以太坊区块: ***/ethereum-vs-harmony-which-blockchain-right-for-you/
[5] 将 RPC 请求提交: ***/leverage-ethereum-blockchain-data-json-rpc/
[6] Chainlist 上找到它。: ***/
[7] 您可以在此处找到指向现有方法的链接: https://docs.metamask.io/guide/rpc-api.html#ethereum-json-rpc-methods
[8] 如果传递给RPC 方法: https://docs.metamask.io/guide/rpc-api.html#ethereum-json-rpc-methods
[9] 您可以从官方资源: https://eips.ethereum.org/EIPS/eip-1474