如何在 Hyperledger Fabric 中正确构建 Java 链码项目-java教程-PHP中文网

如何在 Hyperledger Fabric 中正确构建 Java 链码项目

本文详解 Hyperledger Fabric 官方 Java 链码模板的构建方法，解决因 Gradle 任务变更导致的 Task 'install' not found 报错问题，并提供可直接运行的标准化构建流程。

本文详解 hyperledger fabric 官方 java 链码模板的构建方法，解决因 gradle 任务变更导致的 `task 'install' not found` 报错问题，并提供可直接运行的标准化构建流程。

Hyperledger Fabric 自 v2.5 起已对 Java 链码（Fabric Chaincode for Java）的构建体系进行了升级，官方仓库 hyperledger/fabric-chaincode-java 不再支持已被 Gradle 废弃的 install 任务（该任务自 Gradle 7+ 起移除）。因此，执行 ./gradlew clean build install 会报错：Task 'install' not found in root project。

✅ 正确构建方式如下（推荐使用封装脚本）：

# 进入 fabric-chaincode-java 项目根目录
cd fabric-chaincode-java

# 方法一：使用 wrapper 执行标准构建（生成 JAR 并验证编译）
./gradlew clean build

# 方法二：若需跳过测试（开发调试阶段常用）
./gradlew clean build -x test

# 方法三：仅编译不打包（快速验证语法）
./gradlew compileJava

构建成功后，生成的链码 JAR 包位于：
build/libs/fabric-chaincode-java-.jar
该 JAR 文件即为可部署至 Fabric 网络的链码二进制产物。

⚠️ 注意事项：

Java JDK 25

Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。

下载

Gradle 版本兼容性：当前官方模板基于 Gradle 7.1+ 构建，不兼容 Gradle 8.x。请确认本地 gradle --version 输出为 7.1.1 或 7.6（推荐使用项目自带的 gradlew，它会自动下载匹配版本）；
JDK 要求：必须使用 JDK 11（LTS），JDK 17+ 尚未完全支持（截至 Fabric v2.5）；
无需手动配置 install：Fabric Java 链码通过 fabric-chaincode-shim 启动，不依赖 Maven 的 install 到本地仓库；build 任务已生成完整可部署 JAR；
验证构建结果：运行 ./gradlew tasks 可查看所有可用任务，确认无 install，但存在 build, jar, test 等核心任务。

? 补充说明：若后续需将链码部署到 Fabric 网络，请确保：