在 hyperledger fabric v0.6 中，表的复合主键必须按定义顺序完整提供才能匹配查询；若仅传入后缀字段（如 status），将无法命中——因其底层依赖有序拼接的键范围扫描，而非关系型数据库的任意字段索引。
在 hyperledger fabric v0.6 中，表的复合主键必须按定义顺序完整提供才能匹配查询；若仅传入后缀字段（如 status），将无法命中——因其底层依赖有序拼接的键范围扫描，而非关系型数据库的任意字段索引。
Hyperledger Fabric v0.6 的 CreateTable 机制采用有序复合主键（Ordered Composite Key）设计：所有标记为 Key: true 的列会按声明顺序拼接成一个内部键（例如 "RefNum\x00Status"），并以此作为 LevelDB 存储的唯一键。因此，GetRows() 查询本质上是执行前缀匹配的范围扫描（range query），仅支持从左到右的连续前缀匹配。
以您定义的表结构为例：
// Key order: "RefNum" (first), then "Status" (second)
columnOneTableOneDef := shim.ColumnDefinition{Name: "RefNum", Type: shim.ColumnDefinition_STRING, Key: true}
columnThreeTableOneDef := shim.ColumnDefinition{Name: "Status", Type: shim.ColumnDefinition_STRING, Key: true}
合法查询组合仅有：
Myosin Hivemind Knowledge Retrieval
下载
搜索 Hivemind 精选的 Web3 营销知识库（RAG），获取从业者洞察、框架、实操指南和案例研究。当：(1) an... 时使用此技能。
- ✅
["REF-123"]→ 匹配所有RefNum == "REF-123"的行（前缀完整） - ✅
["REF-123", "PENDING"]→ 精确匹配复合键 - ❌
["PENDING"]→ 无法匹配：因"PENDING"并非任何内部键的左前缀（实际键形如"REF-123\x00PENDING"）
解决方案对比
| 方案 | 适用版本 | 实现方式 | 优缺点 |
|---|---|---|---|
| 多索引建模 | v0.6（推荐） | 为每种查询需求单独建表（如 ReconByStatus），用 Status 作唯一主键，冗余存储关键字段 |
✅ 兼容旧版；❌ 增加写入开销与数据一致性维护成本 |
| 升级至 Fabric v1.0+ | v1.0+ | 使用 stub.CreateCompositeKey() + stub.GetStateByPartialCompositeKey()，支持按定义顺序的前缀子集查询（如仅传 Status） |
✅ 语义清晰、原生支持；❌ 需迁移链码与网络环境 |
| CouchDB + JSON 模式 | v1.0+（启用 CouchDB） | 将数据序列化为 JSON 存入 stub.PutState()，通过富查询（{"selector": {"Status": "PENDING"}}）直接检索任意字段 |
✅ 查询灵活、支持复杂条件；❌ 依赖外部数据库，增加运维复杂度 |
示例：v0.6 多索引兼容实现
若暂无法升级，可为 Status 单独建索引表：
// 创建状态索引表（Status 为唯一主键）
func createStatusIndex(stub shim.ChaincodeStubInterface, refNum, status string) error {
indexKey := status // Status 作为索引表主键
// 存储 RefNum 列表（支持一对多）
existing, _ := stub.GetState("StatusIndex_" + indexKey)
var refs []string
if len(existing) > 0 {
json.Unmarshal(existing, &refs)
}
refs = append(refs, refNum)
data, _ := json.Marshal(refs)
return stub.PutState("StatusIndex_"+indexKey, data)
}
// 查询 Status 对应的所有 RefNum
func queryByStatus(stub shim.ChaincodeStubInterface, status string) ([]string, error) {
data, err := stub.GetState("StatusIndex_" + status)
if err != nil {
return nil, err
}
var refs []string
json.Unmarshal(data, &refs)
return refs, nil
}
⚠️ 重要提醒：Fabric v0.6 已停止维护，且其表格 API 在 v1.0 中被完全移除。强烈建议升级至 Fabric v2.x 或 v3.x，并采用
PutState()/GetStateByRange()+ CouchDB 查询模式，或使用更现代的World State抽象层。遗留系统迁移时，请同步重构数据模型与索引策略，避免陷入“伪关系型”思维陷阱。
