如何调试Hyperledger Fabric环境配置类Shell脚本？

原始脚本代码 #

export PATH=${PWD}/../bin:${PWD}:$PATH 
export FABRIC_CFG_PATH=${PWD}/../config/ 
export CORE_PEER_TLS_ENABLED=true    
export ORDERER_CA=${PWD}/organizations/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem    
export ORDERER_ADDRESS=localhost:7050 
export CORE_PEER_TLS_ROOTCERT_FILE_ORG1=${PWD}/organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt    
export CORE_PEER_TLS_ROOTCERT_FILE_ORG2=${PWD}/organizations/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt
CHANNEL_NAME="samplechannel" CHAINCODE_NAME="PropertyManagement"    CHAINCODE_VERSION="1"    CHAINCODE_PATH="../chaincode/PropertyManagement/build/install/PropertyManagement"    CHAINCODE_LANG="java" CHAINCODE_LABEL="PropertyManagement_1"
       
setEnvVarsForPeer0Org2() {    
    export CORE_PEER_LOCALMSPID="Org2MSP"    
    export CORE_PEER_TLS_ROOTCERT_FILE=$CORE_PEER_TLS_ROOTCERT_FILE_ORG2       
    export CORE_PEER_MSPCONFIGPATH=${PWD}/organizations/peerOrganizations/org2.example.com/users/Admin@org2.example.com/msp    
    export CORE_PEER_ADDRESS=localhost:9051 
}

报错翻译 #

错误：链码路径规范化失败：执行go list命令失败，原因：Go 语言环境未找到主模块，可执行go help modules查看详情，退出状态码 1

排查思路 #

• 修正全局变量定义规则：当前CHANNEL_NAME、CHAINCODE_NAME等全局变量前未加export关键字，后续执行链码相关命令时这些变量不会传递到子进程，会导致命令读取不到参数。需要在变量定义行开头添加export：

  export CHANNEL_NAME="samplechannel" CHAINCODE_NAME="PropertyManagement" CHAINCODE_VERSION="1" CHAINCODE_PATH="../chaincode/PropertyManagement/build/install/PropertyManagement" CHAINCODE_LANG="java" CHAINCODE_LABEL="PropertyManagement_1"
  

• 确认脚本执行方式：不要用sh 脚本名的方式执行脚本，要使用source 脚本名或者. 脚本名的方式执行，否则脚本中export的环境变量只会在子shell中生效，当前终端会话无法读取到配置。
• 确认链码语言参数传递正常：本次报错的核心原因是链码命令默认按照Go语言处理链码，没有读取到CHAINCODE_LANG=java的配置。执行链码相关命令前可执行echo $CHAINCODE_LANG确认变量值是否正常加载。
• 验证链码路径有效性：确认../chaincode/PropertyManagement/build/install/PropertyManagement路径真实存在，且Java链码已经完成编译打包，路径下包含正确的链码启动脚本。
• 校验工作目录匹配性：脚本中所有通过${PWD}拼接的路径，都依赖于执行source命令时的工作目录，可在脚本开头添加echo $PWD确认当前工作目录和路径预期一致。

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