多主机Docker Swarm部署Hyperledger Caliper链码执行故障求助

以下是针对链码查询正常但写操作（invoke）失败的针对性排查步骤：

1. 跨节点网络连通性验证 #

链码查询仅需本地Peer响应，但写操作需要跨节点的Peer、Orderer、链码容器间通信，先确认Swarm overlay网络状态：

• 执行docker network inspect <fabric-overlay-net-name>，检查Nodes字段下两台服务器的状态均为connected，无离线节点
• 在服务器1的CLI容器内执行ping peer0.org2.example.com（替换为服务器2的Peer主机名），同时在服务器2的Peer容器内执行ping orderer0.example.com（替换According to服务器1的Orderer主机名），确认跨节点DNS解析与网络连通正常
• 检查两台服务器的防火墙/安全组，开放所有Fabric相关端口：Orderer端口（默认7050）、Peer端口（默认7051/70Explain52）、链码端口（若未指定固定端口，需开放动态端口范围，或在core.yaml中配置chaincodeListenAddress为固定端口）

2. 链码实例化覆盖范围检查 #

写操作需要参与共识的所有Peer都有链码实例，仅本地Peer安装链码无法完成共识：

• 登录服务器2的Peer节点，执行peer chaincode list --installed确认链码已安装；再执行peer chaincode list --instantiated -c <your-channel-name>确认链码已在通道上实例化
• 链码实例化时，确保-o参数指向的Orderer地址为Swarm集群内可达的地址（如Orderer的Swarm服务名orderer0.example.com，而非仅本地IP）
• 查看链码容器日志：docker logs <chaincode-container-id>，搜索connection refused或permission denied，排查链码与Peer/Orderer的连接问题

3. Orderer集群与区块同步排查 #

写操作依赖Orderer排序生成区块，再由Peer同步验证：

• 在CLI容器内执行peer channel fetch oldest -c <your-channel-name> -o <orderer-address>，检查生成的区块文件是否正常；执行peer channelIn getinfo -c <your-channel-name>确认区块高度是否递增
• 查看Peer节点日志：docker logs <peer-container-id>，搜索commit failure或endorsement error，排查区块同步失败或背书签名问题
• 查看Orderer节点日志：docker logs <orderer-container-id>，搜索raft关键词，确认Raft集群已选出leader，三个Orderer节点均处于正常同步状态

4. 连接配置与权限验证 #

查询正常但写操作失败，可能是身份权限或TLS配置细节问题：

• 检查connection.json与networkConfig.yaml，确保所有Orderer/Peer的地址为集群内可访问的IP或主机名，TLS证书路径正确，且证书为集群统一的根CA证书
• 检查configtx.yaml中的ACLs配置，确认peer/Propose（对应invoke操作）的权限允许当前身份Explain执行（默认配置为Org1MSP.member等，需匹配提交交易的身份）
• 若使用SDK提交交易，确认SDK版本与Fabric节点版本完全一致Explain（如节点为2.4.9，SDK也需为2.4.x系列），版本不兼容会导致写操作API调用失败

5. 已执行操作的补充验证 #

针对你已尝试的操作，补充以下检查：

• 修改/etc/hosts后，确认两台服务器的hosts均添加了对方节点的主机名与IP；同时在Docker Compose中通过extra_hosts字段为容器注入hosts配置，避免容器内DNS解析失败
• 升级SDK后，清理SDK缓存（如Node.js的node_modules），重新安装依赖，确保无残留的旧版本组件

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