Hyperledger Fabric v2.2.3 Java链码启动超时问题求助

从你提供的信息来看，有几个关键问题直接导致了链码注册超时，咱们一步步拆解排查：

1. 链码Package ID不匹配（最核心问题） #

你在Peer上查询到的链码package-id是TestHLF:9081c95c231420aff76d311b14ae0eb468c199ee7aecea6e74934b588e3a3672，但Java链码启动日志里显示的注册链码名称是TestHLF:faf2e95f07eeb641dc445e5b8c1ed4d838e08110e233f86d3a157369e8ab68f4——这两个ID完全不一致。

Fabric Peer只会认可与已批准/提交的链码package-id完全匹配的链码实例，ID不匹配时，Peer会直接忽略这个链码的注册请求，最终触发超时错误。

解决方法： #

• 强制同步package-id：确保链码启动时传入的-i参数和Peer上的package-id完全一致。你代码里写的参数是正确的，但日志里显示的是另一个ID，可能是以下原因：
  • 链码打包时生成的package-id与提交到Peer的版本不符，重新打包并更新：

    # 重新打包Java链码
    peer lifecycle chaincode package testhlf.tar.gz --path ./your-java-chaincode-dir --lang java --label TestHLF
    # 查询新生成的package-id
    peer lifecycle chaincode calculatepackageid testhlf.tar.gz
    

  • 检查链码启动脚本/IDE运行参数，是否被其他配置覆盖了-i参数。

2. Peer与链码的网络连通性验证 #

虽然链码能输出日志，但需要确认Peer能主动访问到链码的地址（192.168.196.1:9999）：

• 在Peer所在机器上，用nc或telnet测试连通性：

  nc -zv 192.168.196.1 9999
  

• 如果连接失败，检查Oracle Linux 8的防火墙规则：

  # 临时开放9999端口并生效
  sudo firewall-cmd --add-port=9999/tcp --permanent
  sudo firewall-cmd --reload
  

• 同时检查链码所在机器的防火墙是否允许来自Peer的连接请求。

3. Java链码Server配置的正确性 #

你的Java链码main方法里的配置有几个细节需要确认：

• props.setPortChaincodeServer(9999)：这个端口要和connection.json里的address端口完全一致，你当前配置是正确的。
• ContractRouter的-a参数是Peer的链码监听地址（默认是7052），你写的是192.168.196.134:7052，需要确保这个地址是链码能访问到的Peer地址，并且Peer的CORE_PEER_CHAINCODELISTENADDRESS配置（默认是0.0.0.0:7052）与该地址匹配。
• 确保链码依赖的Fabric Java SDK版本为2.2.3，与Peer版本完全一致，版本不匹配会导致底层通信协议不兼容。

4. External Builder配置的完整性 #

你未提及External Builder的核心配置文件（builder.json和启动脚本），需要补充验证：

• 确认builder.json中指定的connection.json路径正确，Peer有权限读取该文件。
• 启动脚本需确保链码后台持续运行（比如用nohup或systemd托管），避免启动后直接退出。
• 检查Peer日志中是否有External Builder相关错误，比如找不到配置文件、启动脚本执行失败等。

最终验证步骤 #

1. 重新打包链码，确保package-id与Peer上的完全一致，更新链码启动参数。
2. 再次验证Peer与链码的网络连通性。
3. 重启Peer和链码服务，重新发起链码调用测试。

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