以太坊Java开发入门教程超详细步骤+实例代码，新手看完就能上手操作

刚接触以太坊开发的朋友，是不是一看到 “Java”“智能合约” 这些词就头大？想试试用 Java 开发以太坊相关应用，却不知道从哪儿下手，教程要么太简略，要么全是专业术语看不懂。别担心，今天小编就带大家一步步走进以太坊 Java 开发的世界，保证看完就能动手操作，一起往下看吧！

一、准备开发环境，这些工具不能少

要做以太坊 Java 开发，首先得把环境搭起来。就像盖房子得先准备砖瓦一样，咱们也得把必要的工具装好。

• JDK：推荐用 JDK 11 及以上版本，因为很多以太坊 Java 库对新版本支持更好。安装的时候记得配置环境变量，不然命令行里调用不了 java 命令，这点很重要哦。
• 开发工具：IntelliJ IDEA 是个不错的选择，社区版免费够用，还能装很多以太坊相关的插件，方便开发。Eclipse 也行，但用 IDEA 的人更多，遇到问题好找解决办法。
• 以太坊客户端：Geth 或者 Besu 都行，用来连接以太坊网络，同步区块数据。小编个人更推荐 Besu，因为它是用 Java 写的，和我们的开发语言一致，兼容性可能更好点。
• Maven 或 Gradle：用来管理项目依赖，不用自己手动下载各种 Jar 包，省事儿多了。

这里有个表格，对比一下常用的以太坊客户端，方便大家选择：

客户端名称	开发语言	优势	劣势
Geth	Go	社区活跃，文档多	和 Java 交互需要额外处理
Besu	Java	与 Java 兼容性好，支持多种共识算法	相对 Geth，使用人数稍少

二、创建第一个以太坊 Java 项目，步骤详解

环境准备好了，接下来就该创建项目了。跟着小编的步骤走，保准不出错。

1. 打开 IntelliJ IDEA，点击 “Create New Project”，选择 Maven 项目，勾选 “Create from archetype”，选一个合适的 archetype，比如 maven-archetype-quickstart。
2. 填写 GroupId 和 ArtifactId，这两个就像项目的身份证，自己起个好记的名字就行，比如 GroupId 叫 com.ethereum.demo，ArtifactId 叫 eth-java-starter。
3. 选择 Maven 的安装路径和配置文件，一般默认就行，除非你自己改过。
4. 选个项目存放的目录，点 “Finish”，项目就创建好了。

这时候可能有人问：“为什么要用 Maven 呢？Gradle 不行吗？” 当然可以，Gradle 在依赖管理上也很强大，而且构建速度可能更快。但对于新手来说，Maven 的配置更简单直观，先学会用 Maven，以后再学 Gradle 也不迟。

三、引入以太坊 Java 开发库，关键一步

项目创建好了，得把以太坊相关的 Java 库加进来。就像做菜得放调料，没有这些库，咱们写的代码就没法和以太坊交互。
在 pom.xml 文件里添加依赖，比如 web3j，它是最常用的以太坊 Java 开发库。添加这段代码：
xml

<dependency><groupId>org.web3jgroupId><artifactId>coreartifactId><version>4.9.7version>dependency>

加完之后，Maven 会自动下载这个库，可能需要等一会儿，取决于你的网速。
为什么选 web3j 呢？因为它封装了以太坊的 JSON-RPC 接口，让我们用 Java 代码就能轻松调用，不用自己去处理复杂的网络请求。而且文档丰富，例子也多，特别适合新手。

四、连接以太坊网络，试试这两种方法

环境和项目都搞定了，现在该连接以太坊网络了。怎么连呢？有两种常用方法。
第一种，连接自己本地的节点。先启动 Geth 或 Besu 客户端，同步区块数据。然后用 web3j 连接，代码是这样的：
java

Web3j web3j = Web3j.build(new HttpService("http://localhost:8545"));

这里的 8545 是默认端口，如果你的客户端端口改了，记得换成对应的。
第二种，连接第三方节点服务，比如 Infura。不用自己同步区块，省空间又省时间。代码如下：
java

Web3j web3j = Web3j.build(new HttpService("https://mainnet.infura.io/v3/你的API密钥"));

需要去 Infura 官网注册个账号，拿到 API 密钥才能用。
那什么时候用本地节点，什么时候用第三方服务呢？如果只是做简单开发测试，用第三方服务方便；要是需要处理大量数据，或者对安全性要求高，那就自己搭本地节点。

五、获取以太坊账户信息，实例代码来了

连接上网络，就可以获取账户信息了。比如查账户余额，代码很简单：
java

public class EthAccountExample {public static void main(String[] args) throws IOException {Web3j web3j = Web3j.build(new HttpService("http://localhost:8545"));String address = "0x你的以太坊地址";EthGetBalance balanceResponse = web3j.ethGetBalance(address, DefaultBlockParameterName.LATEST).send();BigInteger balance = balanceResponse.getBalance();System.out.println("账户余额：" + Convert.fromWei(balance.toString(), Convert.Unit.ETHER) + " ETH");web3j.shutdown();}}

运行这段代码，就能看到账户里有多少 ETH 了。这里要注意，地址得是正确的，不然会报错。
有人可能会问：“Convert.fromWei 是干嘛的？” 因为以太坊返回的余额单位是 Wei，1 ETH 等于 10 的 18 次方 Wei，用这个方法可以转换成我们容易看懂的 ETH 单位。

六、部署简单智能合约，体验开发全流程

智能合约是以太坊开发的核心，咱们来试试部署一个简单的合约。先写个 HelloWorld 合约，用 Solidity 语言：
solidity

pragma solidity ^0.8.0;contract HelloWorld {string public message;constructor(string memory _message) {message = _message;}function setMessage(string memory _message) public {message = _message;}}

然后用 web3j 的命令行工具把它转换成 Java 类。打开命令行，进入合约文件所在目录，执行：
plaintext

web3j solidity generate --soliditySource HelloWorld.sol -o 输出目录 -p 包名

生成 Java 类后，就能在项目里用了。部署合约的代码如下：
java

public class DeployContractExample {public static void main(String[] args) throws Exception {Web3j web3j = Web3j.build(new HttpService("http://localhost:8545"));Credentials credentials = Credentials.create("你的私钥");HelloWorld contract = HelloWorld.deploy(web3j, credentials, new DefaultGasProvider(), "Hello, Ethereum!").send();System.out.println("合约地址：" + contract.getContractAddress());web3j.shutdown();}}

部署成功后，会输出合约地址，记下这个地址，后面调用合约要用。
这里有个小提醒，私钥一定要保管好，不能泄露给别人，不然账户里的资产可能会被盗。

七、调用智能合约方法，看看效果

合约部署好了，怎么调用它的方法呢？比如获取 message 和修改 message。
获取 message 的代码：
java

String message = contract.message().send();System.out.println("当前message：" + message);

修改 message 的代码：
java

TransactionReceipt receipt = contract.setMessage("Hello, Java!").send();System.out.println("修改成功，交易哈希：" + receipt.getTransactionHash());

调用修改方法需要消耗 gas，所以账户里得有足够的 ETH，不然会失败。
为什么修改合约状态需要消耗 gas，而查询不需要呢？因为修改状态会改变区块链上的数据，需要全网节点共识，消耗资源；而查询只是读取数据，不改变区块链，所以不用花钱。

八、遇到问题别慌，这些坑我帮你踩过

开发过程中肯定会遇到问题，小编总结了几个常见的，希望能帮到你。

• 连接节点失败：检查节点是否启动，端口是否正确，网络是否通畅。
• 依赖下载不了：换个 Maven 镜像，比如阿里云的，速度快还稳定。
• 合约部署失败：看看账户余额够不够，gas 设置是不是太低，私钥有没有错。

如果遇到其他问题，多看看 web3j 的官方文档，或者去以太坊社区问问，那里有很多热心人。

九、个人心得和建议

做以太坊 Java 开发，刚开始觉得难很正常，多动手实践，遇到问题多查多问，慢慢就熟练了。建议大家先从简单的例子做起，比如查余额、部署简单合约，熟悉之后再做复杂的项目。
平时多关注以太坊和 web3j 的更新，新的版本可能会有更好用的功能和更安全的特性。还有，多看看别人的开源项目，学习他们的代码风格和实现思路，进步会更快。
希望这篇教程能帮到想入门以太坊 Java 开发的朋友，祝大家开发顺利！