无法构建链码：chaincode-docker-devmode正常但basic-network安装报错求助

这个问题我之前帮朋友排查过好几次，大概率是链码路径配置、GOPATH挂载或者Fabric版本不匹配导致的，给你几个分步排查的方案：

1. 确认链码存放路径符合GOPATH规范 #

Fabric链码安装时会遵循Go的GOPATH规则，你的链码必须放在本地$GOPATH/src目录下的对应路径里。比如如果你的链码import了github.com/hyperledger/fabric/core/chaincode/shim，那你的链码项目应该放在类似$GOPATH/src/github.com/your-username/your-chaincode的位置，这样peer节点才能正确找到链码和它的依赖。

2. 检查链码安装命令的路径参数 #

安装链码时，-p参数指定的是相对于$GOPATH/src的相对路径，不是本地的绝对路径。比如你的链码在$GOPATH/src/github.com/my-org/asset-chaincode，那安装命令应该是：

peer chaincode install -n assetcc -v 1.0 -p github.com/my-org/asset-chaincode

如果用了绝对路径（比如/home/user/chaincode），peer容器里会找不到对应的文件。

3. 验证basic-network的GOPATH挂载配置 #

打开basic-network目录下的docker-compose.yml文件，检查peer节点的volumes配置，确保本地的$GOPATH/src目录已经挂载到了peer容器的/opt/gopath/src路径。正常的配置应该类似：

volumes:
  - ../crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/msp:/etc/hyperledger/fabric/msp
  - ../crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls:/etc/hyperledger/fabric/tls
  - ${GOPATH}/src:/opt/gopath/src
  - peer0.org1.example.com:/var/hyperledger/production

如果缺少${GOPATH}/src:/opt/gopath/src这一行，容器里就无法访问本地的链码和依赖包，自然会找不到shim包。

4. 确保Fabric版本与devmode一致 #

chaincode-docker-devmode和basic-network使用的Fabric版本必须匹配：

• 如果你用的是Fabric 1.4.x版本，shim包的路径确实是github.com/hyperledger/fabric/core/chaincode/shim
• 如果你用的是Fabric 2.x及以上版本，shim包的路径已经改为github.com/hyperledger/fabric-chaincode-go/pkg/shim
  如果两个环境版本不一致，就会出现devmode能运行但basic-network报错的情况。可以通过docker images命令查看两个环境的fabric-peer、fabric-orderer等镜像的tag是否一致。

5. 手动进入peer容器排查依赖 #

如果上面的步骤都没问题，可以进入peer容器手动检查：

docker exec -it peer0.org1.example.com bash

然后查看容器内是否存在shim包：

ls /opt/gopath/src/github.com/hyperledger/fabric/core/chaincode/shim

如果这个目录不存在，说明容器里没有Fabric的源码依赖，你可以把本地的Fabric源码目录（比如$GOPATH/src/github.com/hyperledger/fabric）挂载到容器对应的路径，或者在链码目录下使用go mod tidy来管理依赖（适用于Fabric 2.x+）。

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