Hyperledger Fabric同一节点部署多链码失败问题求助

核心问题分析 #

你遇到的情况是单独部署两个链码均正常，但同时部署时其中一个合约/链码无法调用，大概率是链码打包/部署逻辑的混淆或合约注册/调用的参数缺失导致的，以下分两种常见场景给出针对性解决方案：

场景1：你需要部署两个独立的链码（Insurance和ERC20各自为独立链码） #

当前你的链码导出方式错误——把两个合约打包进了同一个链码包，Fabric在加载时可能只优先注册了第一个合约，导致ERC20合约无法被识别。

修复步骤：

1. 将两个合约拆分为独立的链码项目：
   • Insurance链码项目的导出代码：

     const InsuranceClaim = require("./lib/insuranceChaincode");
     module.exports.contracts = [InsuranceClaim];
     

   • ERC20链码项目的导出代码：

     const ERC20Token = require("./lib/ERC20Chaincode");
     module.exports.contracts = [ERC20Token];
     

2. 分别执行链码的打包、安装、实例化流程：
   • 确保两个链码使用不同的链码ID（比如insurancecc和erc20cc）和不同的版本号
   • 检查每个链码的安装/实例化日志，确认所有peer节点均完成安装，且实例化交易得到足够组织的背书

场景2：你需要部署一个包含两个合约的链码（单链码多合约） #

这种情况下你的导出逻辑是正确的，但调用ERC20合约时必须显式指定合约名称，否则Fabric会默认调用第一个注册的合约（InsuranceClaim），导致ERC20函数无法找到。

修复步骤：

1. 调用ERC20合约函数时，必须指定合约名参数：
   • 使用CLI调用时，添加--contract ERC20Token参数，示例：

     peer chaincode invoke -C <通道名> -n <链码ID> --contract ERC20Token -c '{"function":"transfer","Args":["user1","user2","100"]}'
     

   • 使用SDK调用时，在创建合约对象时指定合约名称，示例（以Node.js SDK为例）：

     const erc20Contract = channel.getContract("<链码ID>", "ERC20Token");
     await erc20Contract.submitTransaction("transfer", "user1", "user2", "100");
     

2. 检查链码容器日志，确认两个合约均被正确注册：
   • 查看peer节点或链码容器的日志，搜索RegisterContract关键字，确认同时出现InsuranceClaim和ERC20Token的注册记录

通用排查步骤 #

无论哪种场景，都可以通过以下步骤定位问题：

• 检查peer节点日志：docker logs <peer容器名>，查看ERC20链码/合约的初始化、注册过程是否有错误
• 验证链码状态：
  • 查看已安装的链码：peer chaincode list --installed，确认所有节点都安装了目标链码
  • 查看已实例化的链码：peer chaincode list --instantiated -C <通道名>，确认ERC20链码已在通道上实例化
• 检查链码容器状态：docker ps，确认ERC20对应的链码容器处于运行状态

内容的提问来源于stack exchange，提问作者ADARSH MORADIYA