Hyperledger Fabric链码实例化失败求助：容器启动报错

这个错误本质是peer节点启动链码容器时，找不到指定的chaincode可执行文件——容器的启动命令默认会调用这个文件，但它在容器的环境变量路径里不存在。下面是一步步的排查和解决方法：

1. 先确认链码构建是否正确 #

如果你用的是Go语言链码，这是最容易出问题的环节：

• 切换到你的链码目录下，执行go build -o chaincode，确保生成一个名为chaincode的可执行文件（注意是小写，和容器启动时找的文件名严格一致）。
• 别偷懒跳过这一步，很多人直接用默认的go build生成和目录同名的可执行文件，这会导致容器找不到chaincode这个指定入口文件。

如果是Node.js/Python链码：

• 确保你已经在链码目录下执行了npm install（Node）或安装了对应依赖（Python），并且package.json（Node）里的scripts包含正确的启动命令，比如"start": "fabric-chaincode-node start"——这会确保链码容器能正确找到启动入口。

2. 重新安装链码到peer节点 #

之前的安装包可能因为构建问题不完整，先重新执行安装命令：

peer chaincode install -n test_cc -v 0.1 -p github.com/your-chaincode-path/test_cc

这里的-p参数要对应你链码在peer节点GOPATH下的路径（Go链码），或者链码的本地目录路径（如果用的是打包文件，要确保打包时包含了正确的可执行文件/依赖）。

3. 检查链码镜像的完整性 #

Fabric在实例化时会自动构建链码镜像，你可以手动验证镜像里是否存在chaincode文件：

1. 用docker images找到对应链码的镜像，比如名字类似dev-peer0.org1.example.com-test_cc-0.1的镜像。
2. 启动一个临时容器进入查看：

   docker run -it dev-peer0.org1.example.com-test_cc-0.1 /bin/sh
   

3. 在容器里执行which chaincode，如果返回空，说明镜像里确实没有这个文件——回到步骤1重新构建链码，再重新安装、实例化。

4. 清理残留的链码容器和镜像 #

如果之前有失败的实例化尝试，残留的容器/镜像可能有问题，先清理干净：

# 删除所有链码容器
docker rm -f $(docker ps -aq --filter name=dev-peer*)
# 删除所有链码镜像
docker rmi -f $(docker images -q --filter reference=dev-peer*)

清理完成后，重新执行链码安装和实例化命令。

5. 检查peer节点的链码执行模式 #

确保peer节点的CORE_CHAINCODE_EXECUTETYPE配置是docker（这是默认值，但如果被修改过会出问题）。你可以在peer的启动配置里查看这个环境变量，比如docker-compose.yml里的peer服务环境变量：

environment:
  - CORE_CHAINCODE_EXECUTETYPE=docker

按照上面的步骤排查，基本能解决这个"executable file not found"的问题。

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