搭建单组织Kafka版Hyperledger网络时创建通道遇主体反序列化失败

嘿，这个Principal deserialization failure错误我在搭建单组织Fabric网络时也碰到过几次，大概率和身份配置不匹配或者MSP定义错误有关，结合你已经搞定Docker网络、Kafka/ZooKeeper的情况，给你几个针对性的排查和解决步骤：

• 检查crypto-config与configtx的MSP ID完全匹配
  这是最常见的原因：你在crypto-config.yaml里定义的组织MSP ID，必须和configtx.yaml里所有引用该组织的地方完全一致（大小写、拼写都不能错）。比如：

  • 在crypto-config.yaml里，组织的ID字段是MyFakeOrgMSP
  • 那在configtx.yaml的组织定义、Consortium配置、通道Profile里，所有涉及该组织的MSP引用都必须是MyFakeOrgMSP，不能写成MyFakeOrg或者myfakeorgmsp。

• 验证configtx.yaml里的权限策略配置
  通道创建时的Principal反序列化失败，经常和Policy里的Principal定义错误有关。比如在通道Profile的Application或Orderer部分，检查类似这样的配置：

  Admins:
    Type: Signature
    Rule: "OR('MyFakeOrgMSP.admin')"
  

  这里的MyFakeOrgMSP.admin必须对应你生成的MSP里的角色，确保MSP ID正确，同时角色名称（admin、member）没有写错。

• 检查Orderer和Peer的MSP启动配置
  启动Orderer容器时，要确保环境变量ORDERER_GENERAL_LOCALMSPID设置为正确的MSP ID，并且挂载的MSPDir路径指向cryptogen生成的对应Orderer组织的MSP文件夹；同理，Peer容器的CORE_PEER_LOCALMSPID也要和你的单组织MSP ID一致，证书挂载路径不能错。

• 重新生成所有配置文件，清理残留
  有时候旧的证书或配置文件残留会导致奇怪的问题，建议：

  1. 删除crypto-config文件夹、之前生成的创世块（genesis.block）、通道交易文件（channel.tx）
  2. 重新执行cryptogen generate --config=crypto-config.yaml生成证书
  3. 用正确的通道Profile重新生成通道交易文件：configtxgen -profile MyFakeOrgChannel -outputCreateChannelTx ./channel.tx -channelID mychannel（注意这里要用通道Profile，而不是创世块的Profile）
  4. 重启所有Orderer、Peer容器，再尝试创建通道

• 确认Kafka主题的权限配置
  虽然你说Orderer识别了Kafka节点，但可以顺带检查Orderer配置里的ORDERER_KAFKA_TOPIC是否正确，并且Kafka允许Orderer写入该主题——不过这个和Principal错误关联度较低，但排除一下总没坏处。

如果以上步骤都试过还是不行，可以把configtx.yaml和crypto-config.yaml里的组织相关配置片段贴出来，这样能更精准定位问题。

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