MetaMask无法连接到Localhost 8545网络问题求助

解决方法 #

• 确认Hardhat本地节点处于运行状态：运行npx hardhat node的终端不能关闭，需确认终端输出包含节点监听信息及生成的测试账户列表，默认监听地址为127.0.0.1:8545。
• 核对MetaMask本地网络配置参数：打开MetaMask的网络设置页，找到对应Localhost网络项，确保参数完全匹配：
  • RPC URL：填写http://127.0.0.1:8545，不要使用localhost避免系统解析异常
  • 链ID：必须填31337（Hardhat默认链ID，8545为端口号不是链ID，此处是最常见的配置错误点）
  • 货币符号：ETH，区块浏览器地址可留空
• 排查代理/防火墙拦截：如果开启了全局代理，需将127.0.0.1加入代理忽略列表，或临时关闭代理再尝试连接；同时确认本地防火墙没有拦截8545端口的通信。
• 检查端口占用情况：如果有其他程序（比如Ganache）占用了8545端口，会导致Hardhat节点启动失败。可关闭占用端口的程序，或运行npx hardhat node --port 自定义端口号指定其他端口启动节点，同步修改MetaMask中RPC URL的对应端口即可。
• 重置网络缓存：如果此前配置过同名本地网络，可在MetaMask中删除该网络后重新添加，同时重启Hardhat节点再尝试连接。

注意：导入Hardhat生成的测试账户时，需使用npx hardhat node输出的对应账户私钥，不要误填公钥或助记词。

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