Hardhat

• Soulock
• 2026年06月01日
• • 技术

Hardhat 本地链卡链？先看是不是关了自动挖矿

Hardhat 本地链跑合约，await tx.wait() 卡住不返回，感觉链死了。看着像 bug，其实基本都是配置问题。 快速定位 一条命令看当前区块号： cast block-number --rpc-url http://127.0.0.1:8545没有 cast 就用 curl： curl -X POST http://127.0.0.1:8545 \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'隔几秒再跑一次，区块号不变——链停了。 原因 1：配了 auto: false hardhat.config.js 里如果有： networks: { hardhat: { mining: { auto: false, // 关掉了自动挖矿 // interval: 5000 // 或者只按间隔挖 } } }交易发到内存池后不会被打包，得手动 mine： await network.provider.send("evm_mine");或者恢复自动挖矿： await network.provider.send("evm_setAutomine", [true]);原因 2：nonce 冲突 之前发过一个低 gas 交易占住了某个 nonce，后面的交易全排在它后面： cast nonce 0x<address> --rpc-url http://127.0.0.1:8545解法：发一个相同 nonce、更高 gas 的交易顶掉旧的（cancelTx 模式）。 原因 3：fork 主网时 RPC 挂了 npx hardhat node --fork https://eth-mainnet.g.alchemy.com/v2/xxxAlchemy 超限、RPC 断线、网络超时，Hardhat 表现得就像卡住。开 debug 日志看： DEBUG=hardhat* npx hardhat node会看到"Waiting for chain state"之类的提示。 原因 4：不是链卡，是前端缓存了 Hardhat 每次重启链状态会重置，但前端还拿着旧合约地址、旧 ABI。清理编译产物： rm -rf cache artifacts npx hardhat compile npx hardhat run scripts/deploy.js --network localhost原因 5：evm_mine 返回 0 不等于失败 有人看到： await network.provider.send("evm_mine"); // '0'以为报错了。其实 '0' 是 RPC 的正常返回值，表示成功。区块号会 +1，验证一下： await ethers.provider.getBlockNumber();兜底：一键重置 想快速回到初始状态而不重启进程： await network.provider.request({ method: "hardhat_reset", params: [], });链状态、快照、内存池全清。跑测试之间用这个特别方便。 或者最粗暴——Ctrl+C 结束 npx hardhat node，重新起一个。 一句话总结 Hardhat "卡链" 九成是 auto: false 关了自动挖矿。先 evm_setAutomine [true] 或手动 evm_mine 一下，绝大多数情况就通了。