Metamask无法连接本地Ganache区块链网络问题求助

1. 获取Ganache准确配置参数 #

• 打开Ganache客户端，进入右上角设置页的【Server】标签，直接复制以下三个核心参数：
  • RPC服务地址：默认值为http://127.0.0.1:7545
  • 端口号：默认值为7545
  • 网络ID：默认值为1337，该值同时作为Metamask要求填写的链ID（Chain ID）使用

2. Metamask手动添加网络配置 #

打开Metamask的手动添加网络页面，填入对应参数：

• 网络名称：可自定义，比如Ganache 本地测试网
• RPC URL：填入Ganache里的RPC服务地址 http://127.0.0.1:7545
• 链ID：填入Ganache的网络ID，默认是1337
• 货币符号：可填ETH
• 区块浏览器URL：留空即可

3. 更新truffle-config.js配置 #

原配置没有明确指定chainId且network_id用了通配符，修改为以下内容：

module.exports = {
  networks: {
    development: {
      host: "127.0.0.1",
      port: 7545,
      network_id: "1337", // 和Ganache的网络ID保持一致
      chainId: 1337 // 新增chainId参数，和network_id值一致
    }
  },
  solc: {
    optimizer: {
      enabled: true,
      runs: 200
    }
  }
}

4. 异常排查 #

• 若此前添加过错误的本地网络配置，先在Metamask中删除错误配置后再重新添加，避免缓存冲突
• 确认Ganache处于运行状态，本地防火墙没有拦截7545端口的访问请求
• 不要使用localhost:8545连接，该端口是Hardhat等其他本地区块链工具的默认端口，和Ganache默认端口不匹配
• 若使用Ganache CLI启动服务，可以在启动时指定固定参数避免ID不一致：ganache-cli --chainId 1337 --networkId 1337

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