在Solidity開發過程中，大多數開發者最常遇到的問題不是“代碼寫不了”，而是“代碼部署了，但行為不對”。
本篇文章將帶你梳理一套完整的EVM智能合約調試流程，并附上幾類真實常見報錯場景及排查方法，適用于Hardhat、Remix、Foundry等主流開發環境。
一、EVM合約調試核心邏輯
EVM合約不像前端應用那樣可以“console.log”，調試方式通常依賴：
事件日志（event logs）
交易回執（transaction receipts）
斷點調試（Remix）或調用棧追蹤（Hardhat/Foundry）
測試用例斷言失敗信息（assert/revert）
二、調試環境推薦
? 本地開發環境：Hardhat（推薦）
npm install --save-dev hardhat
可用
console.log()（Hardhat 特有）打印鏈上執行數據可部署本地節點，測試 gas 消耗、交易結果
配合
chai + ethers.js進行單元測試斷言
? 在線IDE：Remix
無需安裝環境，適合快速驗證
支持斷點、變量可視化、事件監視器
? 高級調試工具：Tenderly / Foundry
Tenderly 提供事務可視化 + 模擬回滾
Foundry 支持快速測試生成、fuzz測試等更底層調試方式
三、常見報錯場景 + 調試建議
?? 1. revert / require 報錯
癥狀：交易失敗、回滾，提示 revert
常見原因：
輸入數據格式不對（如 uint256 被傳 string）
權限不匹配（比如
require(msg.sender == owner)）某個合約內部調用失敗，沒有 catch
調試方式：
查看 Hardhat 或 Remix 報錯的
reason字符串在
require()中加入錯誤提示，例如：
require(balance >= amount, "Insufficient balance");
?? 2. 交易卡在 pending 狀態不執行
癥狀：發出的交易長時間未打包
可能原因：
本地測試環境 gasLimit 設置過低
網絡未連接正確 RPC 節點
交易已 nonce 沖突（常見于腳本調用）
調試方式：
檢查 provider 設置
使用 Hardhat 的內置
reset方法清空 pending tx使用 Remix 切換到“London”網絡設置，重新發送交易
?? 3. invalid opcode / out of gas 報錯
癥狀：執行時提示非法操作碼或 gas 耗盡
常見原因：
死循環、遞歸錯誤
未正確初始化 storage 變量
沒有預估 gas 的調用（如調用 view 函數但未
call()）
調試方式：
增加 gasLimit 觀察是否與 gas 相關
打開 Hardhat 控制臺打印調試 log：
import "hardhat/console.sol";
console.log("x=", x);
?? 4. 部署腳本失敗 / test 報錯但找不到原因
建議方法：
使用
console.log定位部署流程中執行步驟加入斷言（assert）觀察狀態：
expect(await contract.owner()).to.eq(deployer.address);
把復雜邏輯拆成多個 it() 測試塊逐一驗證
四、進階技巧：調試復雜合約時的經驗總結
把所有
require()都寫上明確錯誤信息多用 event log 替代冗長狀態變量讀取
模塊化寫合約，每個邏輯拆出一個函數便于單測
給合約寫模擬用例（mock），測試依賴外部合約行為
五、附：基礎 Hardhat 調試模板（Solidity + JS）
// contracts/MyToken.sol
pragma solidity ^0.8.0;contract MyToken {address public owner;uint256 public totalSupply;constructor() {owner = msg.sender;}function mint(uint256 amount) external {require(msg.sender == owner, "Only owner can mint");totalSupply += amount;}
}
// test/MyToken.test.js
const { expect } = require("chai");describe("MyToken", function () {it("should mint correctly", async function () {const [deployer] = await ethers.getSigners();const Token = await ethers.getContractFactory("MyToken");const token = await Token.deploy();await token.mint(100);expect(await token.totalSupply()).to.equal(100);});
});
EVM 調試并不只是解決 bug，而是提升項目質量、用戶體驗、上線穩定性的關鍵環節。
別怕調試，多用工具，多寫斷言，多看日志。
#區塊鏈項目啟動指南 ?
#Solana發幣教程 ?
#智能合約部署 ?
#項目包裝方案 ?
#鏈上推廣實操 ?
#技術驅動創業 ?
#數字產品可視化 ?
#一站式上鏈支持 ?
#技術落地路徑 ?
#Web3增長方法
