Windows系统搭建Hyperledger Fabric首个网络时出现路径缺失等多类报错

报错1：客户端TLS配置获取失败、registerEnroll.sh脚本第26行文件不存在 #

原因 #

Windows下Git Bash的路径自动转换规则和Fabric Shell脚本的路径逻辑冲突，导致路径被重复拼接，出现C:\c\Users\这类错误格式的路径，无法读取对应证书和配置文件。

解决步骤 #

• 执行所有Fabric相关脚本前，先运行命令关闭Git Bash路径自动转换：
  export MSYS_NO_PATHCONV=1
• 清空之前生成的错误组织配置目录：
  rm -rf organizations/peerOrganizations organizations/ordererOrganizations
• 如果使用WSL2运行测试网，不要将fabric-samples放在/mnt/c等Windows挂载盘路径下，移动到WSL本地目录（如/home/你的用户名/）下再操作，避免跨系统文件权限和路径解析问题。

报错2：配置读取错误、找不到configtx.yaml #

原因 #

FABRIC_CFG_PATH环境变量未配置或指向路径错误，configtxgen工具无法找到创世块生成依赖的配置文件。

解决步骤 #

• 进入test-network目录后，先执行命令设置环境变量：
  export FABRIC_CFG_PATH=${PWD}/configtx
• 执行命令验证配置生效，正常会输出configtx.yaml文件信息：
  ls $FABRIC_CFG_PATH | grep configtx.yaml

报错3：排序节点创世块生成失败 #

原因 #

前两类报错未解决，创世块生成依赖的证书、配置文件缺失，导致生成流程中断返回错误码1。

解决步骤 #

完成前两类报错的修复操作后，重新执行测试网启动命令即可，无需额外操作。

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