外部部署Hyperledger Fabric链码时CouchDB索引的正确打包方法

咱们直接说问题核心：你之前的两种打包方式都没对齐Fabric外部链码的规范——要么缺了关键配置文件，要么多了常规链码才需要的代码包，所以安装时才会报错。下面给你一步步拆解正确的打包姿势：

一、先明确外部链码的核心打包逻辑 #

外部链码和常规链码最大的区别是：不需要把链码代码打包进去（因为代码在外部服务独立运行），只需要提供三类核心内容：

1. 连接外部链码服务的connection.json
2. 按指定路径存放CouchDB索引的META-INF目录
3. 告诉Fabric这是外部链码的manifest.yaml配置文件

二、严格遵循的目录结构 #

先创建一个临时打包目录（比如叫cc-temp），里面的结构必须完全如下：

cc-temp/
├── META-INF/
│   ├── statedb/
│   │   └── couchdb/
│   │       └── indexes/
│   │           └── 你的索引文件.json  # 比如user-index.json，所有CouchDB索引都放这里
│   └── manifest.yaml  # 必须存在，指定链码类型
└── connection.json  # 外部链码的连接配置

重点文件细节说明： #

• manifest.yaml：这是你之前大概率漏掉的关键文件！内容要明确指定链码类型为external，示例：

  type: external
  chaincode:
    id: "your-cc-name:1.0"  # 替换成你的链码名称和版本
    runtime: node  # 对应外部链码的运行时，比如golang/java，按需修改
  

• connection.json：配置外部链码服务的地址等信息，示例：

  {
    "address": "my-external-cc-service:9999",  # 外部链码的服务地址+端口
    "dial_timeout": "10s",
    "tls_required": false  # 按需开启TLS
  }
  

• CouchDB索引文件：必须放在META-INF/statedb/couchdb/indexes路径下，Fabric只会从这个固定路径加载索引，路径错了索引就会失效。

三、正确的打包命令 #

进入到cc-temp目录内部，执行打包命令：

tar -czf your-cc-name.tar.gz META-INF connection.json

⚠️ 注意：一定要在cc-temp目录里执行，这样打包后的压缩包根目录就是META-INF和connection.json，而不是包含外层的cc-temp目录——层级错了Fabric会直接解析失败。

四、安装链码 #

用这个打包好的your-cc-name.tar.gz执行安装命令：

peer lifecycle chaincode install your-cc-name.tar.gz

为什么你之前的方式会报错？ #

• 第一种方式：只打包了META-INF和connection.json，但缺少manifest.yaml，Fabric会默认把它当成常规链码处理，找不到代码包就报错。
• 第二种方式：额外打包了code.tar.gz和metadata.json，这是常规链码的打包结构，和外部链码的要求冲突，Fabric解析时会混乱，所以报错。

内容的提问来源于stack exchange，提问作者Niraj Kumar