Hyperledger Fabric 使用 CouchDB 和複雜智慧合約開發

前言

在上個實驗中，我們已經實現了簡單智慧合約實現及使用者端開發，但該實驗中智慧合約只有基礎的增刪改查功能，且其中的資料管理功能與傳統 MySQL 比相差甚遠。本文將在前面實驗的基礎上，將 Hyperledger Fabric 的預設資料庫支援 LevelDB 改為 CouchDB 模式，以實現更復雜的資料檢索功能。此外，對上個實驗的簡單智慧合約進一步進行功能上和設計上的擴充套件，最終實現了智慧合約的分包、分頁查詢、多欄位富查詢、查詢交易歷史記錄等功能。

網路架構

本文網路結構直接將 Hyperledger Fabric無排序組織以Raft協定啟動多個Orderer服務、TLS組織執行維護Orderer服務 中建立的 4-2_RunOrdererByCouncil 複製為 7_CouchDBAndComplexContract 並修改（建議直接將本案例倉庫 FabricLearn 下的 7_CouchDBAndComplexContract 目錄拷貝到本地執行），文中大部分命令在 Hyperledger Fabric客製化聯盟鏈網路工程實踐 中已有介紹因此不會詳細說明，預設情況下，所有操作皆在 7_CouchDBAndComplexContract 根目錄下執行。修改成功後網路共包含四個組織—— council 、 soft 、 web 、 hard ， 其中 council 組織為網路提供 TLS-CA 服務，並且執行維護著三個 orderer 服務；其餘每個組織都執行維護著一個 peer 節點、一個 couchDB 服務、一個 admin 使用者和一個 user 使用者，實驗最終網路結構如下：

項	執行埠	說明
council.ifantasy.net	7050	council 組織的 CA 服務， 為聯盟鏈網路提供 TLS-CA 服務
orderer1.council.ifantasy.net	7051	council 組織的 orderer1 服務
orderer1.council.ifantasy.net	7052	council 組織的 orderer1 服務的 admin 服務
orderer2.council.ifantasy.net	7054	council 組織的 orderer2 服務
orderer2.council.ifantasy.net	7055	council 組織的 orderer2 服務的 admin 服務
orderer3.council.ifantasy.net	7057	council 組織的 orderer3 服務
orderer3.council.ifantasy.net	7058	council 組織的 orderer3 服務的 admin 服務
soft.ifantasy.net	7250	soft 組織的 CA 服務， 包含成員： peer1 、 admin1 、user1
peer1.soft.ifantasy.net	7251	soft 組織的 peer1 成員節點
couchdb.soft.ifantasy.net	7255	soft 組織的 couchdb 成員節點
web.ifantasy.net	7350	web 組織的 CA 服務， 包含成員： peer1 、 admin1 、user1
peer1.web.ifantasy.net	7351	web 組織的 peer1 成員節點
couchdb.web.ifantasy.net	7355	web 組織的 couchdb 成員節點
hard.ifantasy.net	7450	hard 組織的 CA 服務， 包含成員： peer1 、 admin1 、user1
peer1.hard.ifantasy.net	7451	hard 組織的 peer1 成員節點
couchdb.hard.ifantasy.net	7455	hard 組織的 couchdb 成員節點

新增CouchDB支援並啟動網路

新增CouchDB支援

首先，在 envpeer1soft 、 envpeer1soft 、 envpeer1soft 中新增 CouchDB 版本變數：

export COUCHDB_VERSION=3.2

然後，向 compose/docker-base.yaml 檔案新增基礎 CouchDB 映象：

couchdb-base:
    image: couchdb:${COUCHDB_VERSION}
    environment:
      - COUCHDB_USER=admin
      - COUCHDB_PASSWORD=adminpw
    networks:
      - ${DOCKER_NETWORKS}

之後，向 compose/docker-compose.yaml 中的每個組織新增 CouchDB 容器：

couchdb.soft.ifantasy.net:
    container_name: couchdb.soft.ifantasy.net
    extends:
      file: docker-base.yaml
      service: couchdb-base
    ports:
      - 7255:5984

couchdb.web.ifantasy.net:
    container_name: couchdb.web.ifantasy.net
    extends:
      file: docker-base.yaml
      service: couchdb-base
    ports:
      - 7355:5984

couchdb.hard.ifantasy.net:
    container_name: couchdb.hard.ifantasy.net
    extends:
      file: docker-base.yaml
      service: couchdb-base
    ports:
      - 7455:5984

最後，修改 compose/docker-compose.yaml 中每個 peer 容器的儲存方式（以 peer1.soft.ifantasy.net 為例）：

  peer1.soft.ifantasy.net:
    container_name: peer1.soft.ifantasy.net
    extends:
      file: docker-base.yaml
      service: peer-base
    environment:
      - CORE_PEER_ID=peer1.soft.ifantasy.net
      - CORE_PEER_LISTENADDRESS=0.0.0.0:7251
      - CORE_PEER_ADDRESS=peer1.soft.ifantasy.net:7251
      - CORE_PEER_LOCALMSPID=softMSP
      - CORE_PEER_GOSSIP_EXTERNALENDPOINT=peer1.soft.ifantasy.net:7251
      - CORE_LEDGER_STATE_STATEDATABASE=CouchDB
      - CORE_LEDGER_STATE_COUCHDBCONFIG_COUCHDBADDRESS=couchdb.soft.ifantasy.net:5984   # 必須為容器內埠
      - CORE_LEDGER_STATE_COUCHDBCONFIG_USERNAME=admin
      - CORE_LEDGER_STATE_COUCHDBCONFIG_PASSWORD=adminpw
    volumes:
      - ${LOCAL_CA_PATH}/soft.ifantasy.net/registers/peer1:${DOCKER_CA_PATH}/peer
    ports:
      - 7251:7251
    depends_on:
      - couchdb.soft.ifantasy.net

注意，引數 CORE_LEDGER_STATE_COUCHDBCONFIG_COUCHDBADDRESS 後的伺服器埠必須為 couchdb 容器的內部埠，原因不得而知， 完整程式碼見 FabricLearn 下的 7_CouchDBAndComplexContract/compose 目錄。

啟動實驗網路

在上述修改完成後，在 7_CouchDBAndComplexContract 目錄下按順序執行以下命令啟動基礎實驗網路：

1. 設定DNS（如果未設定）： ./setDNS.sh
2. 設定環境變數： source envpeer1soft
3. 啟動CA網路： ./0_Restart.sh
4. 註冊使用者： ./1_RegisterUser.sh
5. 獲取使用者證書： ./2_EnrollUser.sh
6. 設定通道： ./3_Configtxgen.sh

網路啟動成功後可見包含 couchdb 容器：

合約開發

本節所用智慧合約由前一篇文章 Hyperledger Fabric 智慧合約開發及 fabric-sdk-go/fabric-gateway 使用範例 改進(拆分)而來，在上篇文章的基礎上對合約進行分包分檔案處理，使專案具有更好的目錄結構。在實驗根目錄 7_CouchDBAndComplexContract 下建立目錄 project_contract 作為智慧合約根目錄，在 project_contract 下執行以下命令初始化 GO 模組：

go mod init github.com/wefantasy/FabricLearn/7_CouchDBAndComplexContract/project_contract

tools 層

tools 層主要用於編寫智慧合約通用工具，建立 tools/contract.go 工具類，主要包含以下函數：

• ConstructResultByIterator : 根據 fabric 查詢結果 shim.StateQueryIteratorInterface 生成對應切片。

  // 根據查詢結果生成切片
  func ConstructResultByIterator[T interface{}](resultsIterator shim.StateQueryIteratorInterface) ([]*T, error) {
      var txs []*T
      for resultsIterator.HasNext() {
          queryResult, err := resultsIterator.Next()
          if err != nil {
              return nil, err
          }
          var tx T
          err = json.Unmarshal(queryResult.Value, &tx)
          if err != nil {
              return nil, err
          }
          txs = append(txs, &tx)
      }
      fmt.Println("select result length: ", len(txs))
      return txs, nil
  }
  

• SelectByQueryString : 根據 couchdb 查詢字串完成查詢操作，並返回對應切片。

  // 根據查詢字串查詢
  func SelectByQueryString[T interface{}](ctx contractapi.TransactionContextInterface, queryString string) ([]*T, error) {
      resultsIterator, err := ctx.GetStub().GetQueryResult(queryString)
      if err != nil {
          return nil, err
      }
      defer resultsIterator.Close()
  
      return ConstructResultByIterator[T](resultsIterator)
  }
  

• SelectByQueryStringWithPagination : 根據 couchdb 查詢字串分頁查詢，並返回對應切片。

  // 根據擦查詢字串分頁查詢
  func SelectByQueryStringWithPagination[T interface{}](ctx contractapi.TransactionContextInterface, queryString string, pageSize int32, bookmark string) (*model.PaginatedQueryResult[T], error) {
      resultsIterator, responseMetadata, err := ctx.GetStub().GetQueryResultWithPagination(queryString, pageSize, bookmark)
      if err != nil {
          return nil, err
      }
      defer resultsIterator.Close()
      var txs []T
      for resultsIterator.HasNext() {
          queryResult, err := resultsIterator.Next()
          if err != nil {
              return nil, err
          }
          var tx T
          err = json.Unmarshal(queryResult.Value, &tx)
          if err != nil {
              return nil, err
          }
          txs = append(txs, tx)
      }
      return &model.PaginatedQueryResult[T]{
          Records:             txs,
          FetchedRecordsCount: responseMetadata.FetchedRecordsCount,
          Bookmark:            responseMetadata.Bookmark,
      }, nil
  }
  

• SelectHistoryByIndex : 獲得交易建立之後的所有變化（區塊鏈賬本）。

  // 獲得交易建立之後的所有變化.
  func SelectHistoryByIndex[T interface{}](ctx contractapi.TransactionContextInterface, index string) ([]model.HistoryQueryResult[T], error) {
      resultsIterator, err := ctx.GetStub().GetHistoryForKey(index)
      if err != nil {
          return nil, err
      }
      defer resultsIterator.Close()
  
      var records []model.HistoryQueryResult[T]
      for resultsIterator.HasNext() {
          response, err := resultsIterator.Next()
          if err != nil {
              return nil, err
          }
  
          var tx T
          if len(response.Value) > 0 {
              err = json.Unmarshal(response.Value, &tx)
              if err != nil {
                  return nil, err
              }
          }
          record := model.HistoryQueryResult[T]{
              TxId:      response.TxId,
              Record:    tx,
              IsDelete:  response.IsDelete,
          }
          records = append(records, record)
      }
      return records, nil
  }
  

model 層

model層主要用於申明合約所用資料結構，其中 model/project.go 內容如下：

package model

type Project struct {
Table        string `json:"table" form:"table"` //  資料庫標記
ID           string `json:"ID"`                 // 專案唯一ID
Name         string `json:"Name"`               // 專案名稱
Username     string `json:"username"`           // 專案主要負責人
Organization string `json:"Organization"`       // 專案所屬組織
Category     string `json:"Category"`           // 專案所屬類別
Url          string `json:"Url"`                // 專案介紹地址
Describes    string `json:"Describes"`          // 專案描述
}

func (o *Project) Index() string {
o.Table = "project"
return o.ID
}

func (o *Project) IndexKey() string {
return "table~ID~name"
}

func (o *Project) IndexAttr() []string {
return []string{o.Table, o.ID, o.Name}
}

其中 Index 函數用於標識模型的唯一主鍵； IndexKey 函數用於標識自建索引的欄位，其中命名方式必須與欄位申明的結構體標記 json 一致（大小寫）；IndexAttr 用於構造具體的索引。model/user.go 申明瞭使用者的欄位資訊：

package model

// User  使用者表
type User struct {
Table    string `json:"table" form:"table"`       //  資料庫標記
Username string `json:"username" form:"username"` //使用者賬戶
Name     string `json:"name" form:"name"`         //真實姓名
Email    string `json:"email" form:"email"`       //  郵箱
Phone    string `json:"phone" form:"phone"`       //  手機
}

func (o *User) Index() string {
o.Table = "user"
return o.Username
}

func (o *User) IndexKey() string {
return "table~username~name"
}

func (o *User) IndexAttr() []string {
return []string{o.Table, o.Username, o.Name}
}

model/base.go 申明瞭基於 CouchDB 的富查詢結果模型：

package model

import "time"

// 歷史查詢結果
type HistoryQueryResult[T interface{}] struct {
Record    T         `json:"record"`
TxId      string    `json:"txId"`
Timestamp time.Time `json:"timestamp"`
IsDelete  bool      `json:"isDelete"`
}

// 分頁查詢結果
type PaginatedQueryResult[T interface{}] struct {
Records             []T    `json:"records"`
FetchedRecordsCount int32  `json:"fetchedRecordsCount"`
Bookmark            string `json:"bookmark"`
}

contract 層

contract 層用於實現智慧合約的核心邏輯（本範例為 model 的增刪改查），由於結合了 CouchDB ，所以相比上個實驗需要更復雜的實現。以 contract/project.go 為例進行介紹，由於程式碼太長在此就不再貼上（完整程式碼參考 project.go），其中主要功能及實現方式如下：

• 插入資料（ Insert ）：先使用 ctx.GetStub().PutState(tx.Index(), txb) 方法插入資料，然後呼叫ctx.GetStub().CreateCompositeKey(tx.IndexKey(), tx.IndexAttr()) 方法為該資料建立 CouchDB 索引，最後呼叫 ctx.GetStub().PutState(indexKey, value) 將索引存入鏈上。
• 更新資料（ Update ）：先使用 indexKey, err := ctx.GetStub().CreateCompositeKey(otx.IndexKey(), otx.IndexAttr()) 得到舊資料的索引，再呼叫 ctx.GetStub().DelState(indexKey) 刪除舊資料的索引，然後呼叫 ctx.GetStub().PutState(tx.Index(), txb) 更新資料，最後分別呼叫 ctx.GetStub().CreateCompositeKey(tx.IndexKey(), tx.IndexAttr()) 和 ctx.GetStub().PutState(indexKey, value) 建立新資料索引並存入鏈上。
• 刪除資料（ Delete ）：先使用 ctx.GetStub().DelState(anstx.Index()) 刪除舊資料，再呼叫 indexKey, err := ctx.GetStub().CreateCompositeKey(tx.IndexKey(), tx.IndexAttr()) 得到舊資料索引，最後通過 ctx.GetStub().DelState(indexKey) 刪除舊資料索引。
• 讀取指定index的記錄（ SelectByIndex ）：使用形如 {"selector":{"ID":"%s", "table":"project"}} 的 CouchDB 查詢語法根據索引查詢資料。
• 讀取所有資料（ SelectAll ）：使用形如 {"selector":{"table":"project"}} 的 CouchDB 查詢語法查詢所有相關資料。
• 按某索引查詢所有資料（ SelectBySome ）：使用形如 {"selector":{"%s":"%s", "table":"project"}} 的 CouchDB 查詢語法根據索引查詢資料。
• 富分頁查詢所有資料（ SelectAllWithPagination ）：使用形如 {"selector":{"table":"project"}} 的 CouchDB 查詢語法呼叫上述分頁查詢資料工具 tools.SelectByQueryStringWithPagination 來查詢資料。
• 按關鍵字富分頁查詢所有資料 SelectBySomeWithPagination ）：使用形如 {"selector":{"%s":"%s","table":"project"}} 的 CouchDB 查詢語法呼叫上述分頁查詢資料工具 tools.SelectByQueryStringWithPagination 來查詢資料。
• 按某索引查詢資料歷史（ SelectHistoryByIndex ）：呼叫上述歷史資料查詢工具 tools.SelectHistoryByIndex 來查詢資料。

contract/user.go 為 model/user.go 的核心操作邏輯，此範例只包含簡單的功能，完整原始碼參考 user.go。

main 主函數

主函數完整程式碼如下所示：

package main

import (
        "github.com/hyperledger/fabric-contract-api-go/contractapi"
        "github.com/wefantasy/FabricLearn/7_CouchDBAndComplexContract/project_contract/contract"
)

func main() {
        chaincode, err := contractapi.NewChaincode(&contract.UserContract{}, &contract.ProjectContract{})
        if err != nil {
                panic(err)
        }

        if err := chaincode.Start(); err != nil {
                panic(err)
        }
}

多智慧合約只需在 main 的 contractapi.NewChaincode 函數中按順序申明即可。在智慧合約編寫完畢後使用 go mod vendor 來打包依賴，上述工作完成後 project_contract 目錄結構及解釋如下所示：

project_contract
├── contract            // 智慧合約核心邏輯
│   ├── project.go
│   └── user.go
├── go.mod
├── go.sum
├── main.go             // 智慧合約入口函數
├── model               // 申明資料模型
│   ├── base.go         // 申明分頁等資料結構
│   ├── project.go
│   └── user.go
├── tools               // 工具目錄
│   └── contract.go     // 智慧合約通用工具，查詢歷史/分頁查詢等
└── vendor              // 依賴目錄

合約部署和測試

如無特殊說明，以下命令預設執行於實驗根目錄 7_CouchDBAndComplexContract 下：

1. 合約打包

   source envpeer1soft
   peer lifecycle chaincode package basic.tar.gz --path project_contract --label basic_1
   

2. 三組織安裝

    source envpeer1soft
    peer lifecycle chaincode install basic.tar.gz
    peer lifecycle chaincode queryinstalled
    source envpeer1web
    peer lifecycle chaincode install basic.tar.gz
    peer lifecycle chaincode queryinstalled
    source envpeer1hard
    peer lifecycle chaincode install basic.tar.gz
    peer lifecycle chaincode queryinstalled
   

3. 三組織批准

   export CHAINCODE_ID=basic_1:22e38a78d2ddfe9c3cbeff91140ee209c901adcc24cd2b11f863a53abcdc825a
   source envpeer1soft
   peer lifecycle chaincode approveformyorg -o orderer1.council.ifantasy.net:7051 --tls --cafile $ORDERER_CA  --channelID testchannel --name basic --version 1.0 --sequence 1 --waitForEvent --package-id $CHAINCODE_ID
   peer lifecycle chaincode queryapproved -C testchannel -n basic --sequence 1
   source envpeer1web
   peer lifecycle chaincode approveformyorg -o orderer3.council.ifantasy.net:7057 --tls --cafile $ORDERER_CA  --channelID testchannel --name basic --version 1.0 --sequence 1 --waitForEvent --package-id $CHAINCODE_ID
   peer lifecycle chaincode queryapproved -C testchannel -n basic --sequence 1
   source envpeer1hard
   peer lifecycle chaincode approveformyorg -o orderer2.council.ifantasy.net:7054 --tls --cafile $ORDERER_CA  --channelID testchannel --name basic --version 1.0 --sequence 1 --waitForEvent --package-id $CHAINCODE_ID
   peer lifecycle chaincode queryapproved -C testchannel -n basic --sequence 1
   

   注意：由於我們有兩個智慧合約，且每個智慧合約都包含 InitLedger 函數來初始化資料，所以在這裡以及後續鏈碼操作中需要刪除 --init-required 引數（因為合約不需要初始化）。
4. 提交鏈碼

   source envpeer1soft
   peer lifecycle chaincode commit -o orderer2.council.ifantasy.net:7054 --tls --cafile $ORDERER_CA --channelID testchannel --name basic --version 1.0 --sequence 1 --peerAddresses peer1.soft.ifantasy.net:7251 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE --peerAddresses peer1.web.ifantasy.net:7351 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE
   

5. 初始化鏈碼資料並測試

   source envpeer1soft
   peer chaincode invoke -o orderer1.council.ifantasy.net:7051 --tls --cafile $ORDERER_CA --channelID testchannel --name basic --peerAddresses peer1.soft.ifantasy.net:7251 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE --peerAddresses peer1.web.ifantasy.net:7351 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE -c '{"Args":["UserContract:InitLedger"]}'
   peer chaincode invoke -o orderer1.council.ifantasy.net:7051 --tls --cafile $ORDERER_CA --channelID testchannel --name basic --peerAddresses peer1.soft.ifantasy.net:7251 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE --peerAddresses peer1.web.ifantasy.net:7351 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE -c '{"Args":["ProjectContract:InitLedger"]}'
   
   peer chaincode invoke -o orderer1.council.ifantasy.net:7051 --tls --cafile $ORDERER_CA --channelID testchannel --name basic --peerAddresses peer1.soft.ifantasy.net:7251 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE --peerAddresses peer1.web.ifantasy.net:7351 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE -c '{"Args":["UserContract:GetAllUsers"]}'
   peer chaincode invoke -o orderer1.council.ifantasy.net:7051 --tls --cafile $ORDERER_CA --channelID testchannel --name basic --peerAddresses peer1.soft.ifantasy.net:7251 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE --peerAddresses peer1.web.ifantasy.net:7351 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE -c '{"Args":["ProjectContract:SelectAll"]}'
   peer chaincode invoke -o orderer1.council.ifantasy.net:7051 --tls --cafile $ORDERER_CA --channelID testchannel --name basic --peerAddresses peer1.soft.ifantasy.net:7251 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE --peerAddresses peer1.web.ifantasy.net:7351 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE -c '{"Args":["ProjectContract:SelectBySome", "name", "工作室聯盟鏈管理系統"]}'
   

注意，在多合約的情況下呼叫鏈碼，需要在所呼叫的合約函數前指定所屬合約，如 ProjectContract:SelectBySome ,其它合約範例呼叫方式大致一樣，在此不再贅述。此外由於 CouchDB 自帶了資料庫管理介面，則可以通過本例中任意一個 CouchDB 的服務地址來存取鏈上資料，如 http://192.168.27.72:7355/_utils/#login （虛擬機器器IP為 192.168.27.72 ，soft 組織的 CouchDB 埠 7355），輸入docker中設定的賬戶admin密碼adminpw即可進入系統：


至此，本實驗基本完成。

可能存在的問題

1. peer lifecycle chaincode install 時遇到錯誤：

Error creating tx-manage chaincode: Error compiling schema for DataContract [SelectBySomeWithPagination]. Return schema invalid. Object has no key 'PaginatedQueryResult[github.com'
panic: Error creating tx-manage chaincode: Error compiling schema for DataContract [SelectBySomeWithPagination]. Return schema invalid. Object has no key 'PaginatedQueryResult[github.com'

goroutine 1 [running]:
log.Panicf({0xa24b02?, 0x1?}, {0xc00014ff50?, 0x407679?, 0x404c71?})
        /usr/local/go/src/log/log.go:392 +0x67
main.main()
        /chaincode/input/src/main.go:201 +0x8e

原因及解決方法： 所用 docker fabric 2.4 映象的 Golang 版本太低不支援泛型，需要刪除並重新安裝 docker fabric 2.4 （儘管 tag 一樣，但映象內容會更新）。

2. 智慧合約呼叫時遇到錯誤：

[notice] 2022-11-13T12:13:49.502557Z nonode@nohost <0.286.0> -------- rexi_server : started servers
[notice] 2022-11-13T12:13:49.504490Z nonode@nohost <0.290.0> -------- rexi_buffer : started servers
[warning] 2022-11-13T12:13:49.530610Z nonode@nohost <0.298.0> -------- creating missing database: _nodes
[info] 2022-11-13T12:13:49.530670Z nonode@nohost <0.299.0> -------- open_result error {not_found,no_db_file} for _nodes
[error] 2022-11-13T12:13:49.537681Z nonode@nohost <0.304.0> -------- CRASH REPORT Process  (<0.304.0>) with 2 neighbors crashed with reason: no match of right hand value {error,enospc} at couch_bt_engine:init/2(line:154) <= 
……

原因及解決方法： 可能是 docker volume 把硬碟佔滿了，使用 docker volume rm $(docker volume ls -qf dangling=true) 清除所有再重試
使用

3. 遇到錯誤：

# github.com/hyperledger/fabric-sdk-go/internal/github.com/hyperledger/fabric/discovery/client
/root/go/pkg/mod/github.com/hyperledger/[email protected]/internal/github.com/hyperledger/fabric/discovery/client/api.go:47:38: undefined: discovery.ChaincodeCall
/root/go/pkg/mod/github.com/hyperledger/[email protected]/internal/github.com/hyperledger/fabric/discovery/client/client.go:83:63: undefined: discovery.ChaincodeInterest
/root/go/pkg/mod/github.com/hyperledger/[email protected]/internal/github.com/hyperledger/fabric/discovery/client/client.go:120:65: undefined: discovery.ChaincodeCall
/root/go/pkg/mod/github.com/hyperledger/[email protected]/internal/github.com/hyperledger/fabric/discovery/client/client.go:124:23: undefined: discovery.ChaincodeInterest
/root/go/pkg/mod/github.com/hyperledger/[email protected]/internal/github.com/hyperledger/fabric/discovery/client/client.go:229:105: undefined: discovery.ChaincodeCall
/root/go/pkg/mod/github.com/hyperledger/[email protected]/internal/github.com/hyperledger/fabric/discovery/client/client.go:247:64: undefined: discovery.ChaincodeCall
/root/go/pkg/mod/github.com/hyperledger/[email protected]/internal/github.com/hyperledger/fabric/discovery/client/client.go:604:48: undefined: discovery.ChaincodeInterest
/root/go/pkg/mod/github.com/hyperledger/[email protected]/internal/github.com/hyperledger/fabric/discovery/client/client.go:620:35: undefined: discovery.ChaincodeCall

原因及解決方法： github.com/hyperledger/fabric-sdk-go 需要指定 20220117 版本，將 go.mod 檔案對應依賴替換如下：

github.com/hyperledger/fabric-sdk-go v1.0.1-0.20220117114400-c848d119936b。

4. 遇到錯誤：

Error compiling schema for ****[**]. Return schema invalid. Object has no key 'Wrapper[[]<part of module name>'

原因及解決方法：智慧合約返回值不支援泛型，將智慧合約返回值換成 interface{} 即可。

5. 查詢歷史記錄出現遇到錯誤：

Error: could not assemble transaction: ProposalResponsePayloads do not match (base64):

原因及解決方法：鏈碼輸出（返回）資料中不要使用地址傳遞（推薦值傳遞），因為地址都是動態分配，每次取到的值都不一樣，造成共識失敗。

6. 遇到錯誤：

Failed to evaluate: Multiple errors occurred: - Transaction processing for endorser [localhost:7451]: Chaincode status Code: (500) UNKNOWN. Description: Error handling success response. Value did not match schema:\n1. return: Invalid type. Expected: array, given: string - Transaction processing for endorser [localhost:7251]: Chaincode status Code: (500) UNKNOWN. Description: Error handling success response. Value did not match schema:\n1. return: Invalid type. Expected: array, given: string

原因及解決方法：鏈碼返回值不能為 []byte ，這是一個 fabric 的 bug，對於複雜返回型別建議直接返回字串 string