M1 MacBook部署Hyperledger Fabric链码报错无linux/arm64/v8匹配镜像

问题根因 #

你遇到的报错核心原因是Hyperledger Fabric 2.3版本的hyperledger/fabric-nodeenv官方镜像未提供适配M1芯片的linux/arm64/v8架构版本，Docker默认会拉取和当前设备架构匹配的镜像，因此找不到对应镜像清单导致拉取失败。

解决方案 #

方案1：临时指定Docker使用x86_64架构运行命令（最快捷） #

M1芯片的Docker Desktop自带Rosetta 2转译功能，可以直接运行x86架构的镜像，执行部署命令时新增架构指定的环境变量即可：

DOCKER_DEFAULT_PLATFORM=linux/amd64 ./network.sh deployCC -ccn basic -ccp ../asset-transfer-basic/chaincode-javascript/ -ccl javascript

如果需要长期生效，可以把export DOCKER_DEFAULT_PLATFORM=linux/amd64添加到当前用户的~/.zshrc（Zsh终端）或~/.bashrc（Bash终端）文件中，执行source ~/.zshrc或source ~/.bashrc后生效。

方案2：升级Hyperledger Fabric版本（长期适配） #

Hyperledger Fabric从2.4版本开始官方所有镜像都已提供arm64架构版本，你可以将当前使用的Fabric Samples及相关二进制文件、镜像版本升级到2.4及以上的LTS版本，即可原生适配M1芯片，无需额外架构指定。

方案3：手动拉取x86架构镜像打本地标签 #

如果不想修改部署命令，也可以提前手动拉取对应版本的x86架构镜像，Docker会自动用转译运行：

docker pull --platform linux/amd64 hyperledger/fabric-nodeenv:2.3

拉取完成后重新执行原部署命令即可。

内容的提问来源于stack exchange，提问作者Edmund Chee