Hyperledger Fabric排序节点升级启动失败报错求助

问题根源分析 #

从容器日志的报错信息可以直接定位问题：

2022-10-24 14:53:07.899 UTC [orderer.common.server] Main -> ERRO 001 failed to parse config:  Error unmarshaling config into struct: 2 error(s) decoding:

* cannot parse 'General.ListenPort' as uint: strconv.ParseUint: parsing "'7050'": invalid syntax
* cannot parse 'General.TLS.Enabled' as bool: strconv.ParseBool: parsing "'true'": invalid syntax

核心原因是环境变量的值被多余的单引号包裹，导致排序节点无法将带单引号的字符串解析为预期的数值（uint）和布尔（bool）类型。

解决步骤 #

1. 修正环境变量文件
   打开你使用的./envord.list文件，找到对应环境变量（通常是带FABRIC_ORDERER_前缀的变量），去掉值两端的单引号：

   • 错误写法：

     FABRIC_ORDERER_GENERAL_LISTENPORT='7050'
     FABRIC_ORDERER_GENERAL_TLS_ENABLED='true'
     

   • 正确写法：

     FABRIC_ORDERER_GENERAL_LISTENPORT=7050
     FABRIC_ORDERER_GENERAL_TLS_ENABLED=true
     

   注意：Docker环境变量文件中，数值、布尔类型变量不需要加引号；仅字符串类型变量包含空格时，才需要用双引号包裹。

2. 清理异常容器
   删除当前无法启动的容器：

   docker rm -f b0d56da4a9f082bc7c5c0dea1e81ba3bf30c55be8f306b0a27986c706a056da4
   

3. 重新启动排序节点
   使用修正后的环境变量文件重新启动容器：

   docker run -d -v ${PWD}/backup/orderer/$ORDERER_CONTAINER/:/var/hyperledger/production/orderer/ \
               -v ${PWD}/backup/msp/$ORDERER_CONTAINER/:/etc/hyperledger/fabric/msp/ \
               --env-file ./envord.list \
               --name $ORDERER_CONTAINER \
               hyperledger/fabric-orderer:$IMAGE_TAG orderer
   

4. 验证启动状态
   检查容器是否正常运行：

   docker ps | grep $ORDERER_CONTAINER
   

   同时查看日志确认无报错：

   docker logs $ORDERER_CONTAINER
   

额外排查提示 #

• 确保备份的账本和MSP目录权限正确，Fabric容器默认使用UID/GID为1000的用户，可通过以下命令调整权限：

  chown -R 1000:1000 ./backup/
  

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