链码启动报错：ERRO 003 连接本地Peer超时求助

我之前碰到好几个开发者在跑《Chaincode for Developers》教程时遇到这个一模一样的错误，别慌，这基本都是链码和本地peer的连接通路出了问题，给你几个按优先级来的排查和修复步骤：

• 检查链码的连接配置是否正确
  确保你在启动链码时用的CORE_PEER_ADDRESS参数是对的，比如本地peer默认的地址通常是localhost:7052（注意不是peer的对外端口7051）。你可以先在终端里用netstat -an | grep 7052（Linux/macOS）或者netstat -ano | findstr 7052（Windows）看看这个端口有没有被peer占用，如果没查到，说明peer没正常启动或者端口配置错了。

• 确认peer容器和本地网络的连通性
  如果你是用Docker跑的peer，先检查peer容器是否正常运行：docker ps，找到peer的容器ID，然后进入容器内部ping一下你的本地机器IP（别用localhost，因为容器里的localhost是它自己），比如docker exec -it <peer-container-id> ping 192.168.1.100（换成你的实际IP）。如果ping不通，大概率是Docker的网络模式或者防火墙的问题，试试关闭本地防火墙，或者把peer容器的网络改成host模式（启动容器时加--network host参数）。

• 检查链码的环境变量设置
  启动链码前要确保正确设置了必要的环境变量，比如：

  export CORE_PEER_ADDRESS=localhost:7052
  export CORE_CHAINCODE_ID_NAME=mycc:1.0
  export CORE_PEER_LOCALMSPID=Org1MSP
  export CORE_PEER_MSPCONFIGPATH=/path/to/your/msp/folder
  

  尤其是CORE_PEER_MSPCONFIGPATH，一定要指向正确的MSP目录，路径错了的话链码连不上peer的身份验证服务，也会超时。

• 重启peer和链码进程
  有时候就是进程卡死了，先把peer容器停掉再重启：docker stop <peer-container-id> && docker start <peer-container-id>，然后把终端2里的链码进程杀掉，重新执行构建和启动命令，说不定就好了。

• 排查链码代码里的初始化逻辑
  如果上面的步骤都试过还是不行，看看你的链码Init或者Instantiate函数里有没有耗时太长的操作，比如无限循环、远程调用超时，这些会导致链码启动时和peer的握手超时，触发这个错误。

补充一句：这个错误本质是链码在规定时间内没法和peer建立GRPC连接，所以所有排查方向都围绕"连通性"和"超时条件"来就行。

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