Goerli（ Görli ）是以太坊官方推荐的 PoA 测试网，兼容以太坊主网生态，是 dApp 上线主网前验证功能、测试交互的核心环境。本文以「Hardhat 框架 + Solidity 智能合约 + React 前端」为例，完整讲解 dApp 部署到 Goerli 测试链的全流程，包含环境搭建、合约部署、前端集成、功能验证等核心环节。
一、前置准备：核心工具与测试资源
1. 必选工具清单
工具 / 资源 作用 获取方式
MetaMask 钱包 管理测试网账户、签名交易 官网下载插件 / APP
Goerli 测试 ETH 支付部署 / 交互的 Gas 费用 水龙头（Alchemy/Goerli Faucet）
Alchemy/Infura API Key 提供 Goerli 测试网 RPC 节点 官网注册获取（免费）
Node.js (v16+) 运行 Hardhat / 前端项目 官网下载
Hardhat 以太坊合约开发 / 部署框架 npm 安装
Ethers.js 与区块链交互的 JS 库 npm 安装
Etherscan API Key 验证合约源码（可选） Etherscan 官网注册
2. 关键准备步骤
（1）配置 MetaMask 连接 Goerli 测试网
打开 MetaMask → 点击网络下拉框 → 选择「Goerli 测试网络」（若无则手动添加：
网络名称：Goerli Testnet
RPC URL：cn-imtoken.com[你的API Key]
链 ID：5
符号：ETH
浏览器：bitpie.im
创建 / 导入测试账户（记录私钥，部署时需用，切勿泄露）。
（2）获取 Goerli 测试 ETH
测试网 ETH 免费获取，常用水龙头：
Alchemy （需 Alchemy 账号）
Paradigm （输入钱包地址即可）
验证：MetaMask 切换到 Goerli 网络，查看账户余额（≥0.1 ETH 即可满足部署需求）。
二、环境搭建：初始化 Hardhat 合约开发项目
1. 初始化项目
新建项目文件夹，执行以下命令：
2. 创建 Hardhat 项目
执行初始化命令并选择「Create a basic sample project」：
3. 配置环境变量（安全关键）
手动创建.env文件，填入以下内容（替换为自己的信息）
三、智能合约开发与编译
1. 编写示例合约
在contracts/目录下创建SimpleDapp.sol，实现一个简单的计数器合约（便于测试）
2. 编译合约
修改hardhat.config.js，配置编译器版本（与合约一致）
编译成功后会生成artifacts/目录（包含合约 ABI 和字节码），部署和前端交互需用到 ABI。
四、部署合约到 Goerli 测试链
1. 编写部署脚本
在scripts/目录下创建deploy.js
2. 执行部署命令
npx hardhat run scripts/deploy.js --network goerli
部署成功后会输出合约地址（示例：0x1234567890abcdef1234567890abcdef12345678），务必保存该地址，后续前端交互和验证合约都需要。
部署失败排查：
检查私钥是否正确、测试账户是否有 Goerli ETH；
检查 Alchemy RPC URL 是否有效；
确认网络是否切换为 Goerli（MetaMask）。
3. 验证合约（可选，增强可信度）
部署后在 Etherscan 验证合约源码，便于查看和交互
五、前端集成：连接 Goerli 测试网并调用合约
前端需实现「连接 MetaMask 钱包→调用合约方法→展示结果」，以 React 为例：
1. 初始化前端项目
2. 配置前端环境变量
创建.env文件，填入合约地址和 ABI（ABI 可从artifacts/contracts/SimpleDapp.sol/SimpleDapp.json的abi字段复制）
3. 编写前端交互代码
修改src/App.js
六、功能验证：完整测试流程
1. 基础验证步骤
点击「连接 MetaMask 钱包」，授权并确认连接（确保 MetaMask 切换到 Goerli 网络）；
点击「增加计数」，MetaMask 会弹出交易确认框，确认后等待交易上链（约 10-30 秒）；
页面自动更新计数，验证是否加 1；
点击「减少计数」，验证计数是否减 1（若计数为 0，会提示「Count cannot be negative」）；
查看交易记录：在 MetaMask「历史记录」或 Goerli Etherscan 搜索合约地址 / 钱包地址，确认交易成功。
2. 核心验证点
验证项 验证方式
合约部署成功 Goerli Etherscan 搜索合约地址，状态显示「Deployed」
交易上链 Etherscan 查看交易哈希，状态显示「Success」
合约状态更新 调用getCount返回最新值，与前端展示一致
Gas 费用消耗 MetaMask 或 Etherscan 查看交易的 Gas 消耗（测试网无实际成本）
权限 / 逻辑校验 测试计数为 0 时调用decrement，是否触发 revert
