在 hyperledger fabric v0.6 中，表的复合主键需严格按定义顺序提供才能成功查询；若仅按非首位置键（如 status）查询将失败。升级至 v1.0+ 后，可通过复合键子集查询或启用 couchdb 支持 json 全字段查询。
在 hyperledger fabric v0.6 中，表的复合主键需严格按定义顺序提供才能成功查询；若仅按非首位置键（如 status）查询将失败。升级至 v1.0+ 后，可通过复合键子集查询或启用 couchdb 支持 json 全字段查询。
Hyperledger Fabric 的 CreateTable 机制（v0.6 及早期版本）并非传统关系型数据库，其“主键”实为有序复合键（ordered composite key），底层依赖 LevelDB 的字节序范围扫描（range scan）。这意味着：键字段的顺序即索引顺序，查询时必须从左到右连续提供前缀字段 —— 类似于文件系统路径 /RefNum/Status，你可查 /ABC123/ 或 /ABC123/PAID，但无法跳过第一级直接查 /*/PAID。
在你的示例中：
columnOneTableOneDef := shim.ColumnDefinition{Name: "RefNum", Type: shim.ColumnDefinition_STRING, Key: true}
columnThreeTableOneDef := shim.ColumnDefinition{Name: "Status", Type: shim.ColumnDefinition_STRING, Key: true}RefNum 是第一主键，Status 是第二主键。因此以下查询有效：
- ✅
GetRows("Recon", []shim.Column{colRefNum})→ 匹配所有RefNum="ABC123"的行 - ✅
GetRows("Recon", []shim.Column{colRefNum, colStatus})→ 精确匹配(RefNum, Status)对
但以下查询无效：
- ❌
GetRows("Recon", []shim.Column{colStatus})→ 缺失首键RefNum，底层无法构造合法范围起始点，返回空结果。
解决方案对比
| 方案 | 适用版本 | 实现方式 | 说明 |
|---|---|---|---|
| 多索引建模 | v0.6 / v1.0 | 为每种查询需求创建独立表（如 ReconByStatus） |
需手动维护冗余数据，增加写入开销与一致性风险 |
| 升级至 Fabric v1.0+ 复合键 API | v1.0+ | 使用 stub.CreateCompositeKey() + stub.GetStateByPartialCompositeKey()
|
支持按复合键前缀查询，例如仅传 RefNum 或 RefNum+Status，但仍不支持跳过首键（如只查 Status） |
| CouchDB + JSON 数据模型 | v1.0+（需配置 CouchDB 为 state database） | 将整条记录存为 JSON，并通过 Mango 查询语法（如 {"selector": {"Status": "PAID"}}） |
真正支持任意字段、组合条件、范围及全文查询，推荐生产环境首选 |
推荐实践：CouchDB 查询示例（Fabric v2.x）
首先确保 peer 配置启用 CouchDB：
Myosin Hivemind Knowledge Retrieval
下载
搜索 Hivemind 精选的 Web3 营销知识库（RAG），获取从业者洞察、框架、实操指南和案例研究。当：(1) an... 时使用此技能。
# core.yaml stateDatabase: CouchDB couchDBConfig: couchDBAddress: couchdb:5984
链码中存储结构化 JSON：
type ReconRecord struct {
DocType string `json:"docType"` // 必须字段，用于区分文档类型
RefNum string `json:"refNum"`
Amount string `json:"amount"`
Status string `json:"status"`
}
// 存储
record := ReconRecord{
DocType: "recon",
RefNum: "ABC123",
Amount: "100.00",
Status: "PAID",
}
bytes, _ := json.Marshal(record)
stub.PutState("recon_" + record.RefNum, bytes) // key 可为任意唯一值执行灵活查询：
// 查询所有 Status = "PAID" 的记录
queryStr := `{"selector":{"docType":"recon","status":"PAID"}}`
resultsIterator, err := stub.GetQueryResult(queryStr)
if err != nil {
return nil, err
}
defer resultsIterator.Close()
var results []ReconRecord
for resultsIterator.HasNext() {
queryResponse, err := resultsIterator.Next()
if err != nil {
return nil, err
}
var record ReconRecord
json.Unmarshal(queryResponse.Value, &record)
results = append(results, record)
}⚠️ 重要提醒：
- Fabric v0.6 不支持 CouchDB，且其
GetRowsAPI 无跳过前缀能力；强行绕过需自行构建全量扫描逻辑（性能极差，禁止用于生产）；- 升级 Fabric 版本是解锁高级查询能力的前提；
- 若暂无法升级，唯一合规方式是为高频查询字段（如
Status）单独建索引表，并在PutState时同步写入多份索引（例如statusIndex_PAID_abc123 → {"refNum":"ABC123"}），但需严格保证事务一致性。
综上，面对“仅按 Status 查询”的需求，最可持续的路径是升级至 Fabric v1.0+ 并采用 CouchDB 后端 —— 它将链码从键值存储的约束中解放出来，使查询逻辑回归开发者直觉，大幅降低建模复杂度与运维成本。
