HyperLedger Fabric链码安装失败问题求助

错误信息：

Error: chaincode install failed with status: 500 - failed to invoke backing implementation of 'InstallChaincode': could not build chaincode: docker build failed: docker image build failed: docker build failed: Failed to pull hyperledger/fabric-nodeenv:2.2: no matching manifest for linux/arm64/v8 in the manifest list entries
Chaincode installation on peer0.org1 has failed
Deploying chaincode failed

核心原因 #

HyperLedger Fabric 2.2版本的hyperledger/fabric-nodeenv镜像官方未提供arm64/v8架构适配包，你的机器为arm64架构（如M系列Mac），导致Docker无法拉取对应架构的镜像。

解决方案 #

• 方案1：升级Fabric版本（最优解）
  升级到Fabric 2.4及以上版本，官方从2.4版本开始全面支持arm64架构。修改链码部署配置及Docker-compose文件中的镜像版本，将hyperledger/fabric-nodeenv:2.2替换为hyperledger/fabric-nodeenv:2.4（或更高兼容版本），重新执行链码安装流程。

• 方案2：手动构建arm64版本的fabric-nodeenv:2.2镜像

  1. 克隆HyperLedger Fabric官方仓库并切换到v2.2分支：git clone --branch v2.2 https://github.com/hyperledger/fabric.git
  2. 进入fabric-nodeenv目录：cd fabric/images/nodeenv
  3. 在arm64机器上执行构建命令：docker build -t hyperledger/fabric-nodeenv:2.2 .
  4. 构建完成后重新尝试链码安装。

• 方案3：启用Docker架构模拟（临时兼容方案）
  通过QEMU模拟x86_64架构运行x86版本镜像，步骤如下：

  1. 执行命令安装QEMU静态编译文件：docker run --privileged --rm tonistiigi/binfmt --install all
  2. 重启Docker Desktop后，重新尝试拉取镜像和安装链码。此方案会带来一定性能损耗，仅适合临时测试场景。

内容的提问来源于stack exchange，提问作者Kana Shimizu