易懂案例：用班费记账来理解区块链Fabric查询系统链码、GetBlockByNumber()方法、deploy()方法、upgrade()方法、getccinfo()方法、getccdata()方法

用班费记账理解区块链Fabric查询系统链码及核心方法

在Hyperledger Fabric中，查询系统链码（Query System Chaincode，QSCC）是负责账本数据查询的核心组件，相当于区块链网络的"账本检索中心"。它与生命周期系统链码（LSCC）分工协作，共同支撑区块链的可追溯性和可管理性。如果将Fabric的账本比作班级的"班费总账本"，那么QSCC就是这本账本的"目录索引工具"，而LSCC的deploy()、upgrade()等方法则是"规则手册的管理工具"。下面我们用班费记账场景，详细解析QSCC、其核心方法及与LSCC方法的区别与联系。

一、查询系统链码（QSCC）：班费总账本的"目录索引工具"

（一）核心原理与定位

查询系统链码（QSCC）是Fabric内置的系统链码，专门提供区块链账本数据的查询接口，支持按区块号、交易ID、通道名称等条件查询区块和交易信息。它就像班级"班费总账本"的目录索引，记录着每笔交易在账本中的位置，方便快速检索：

• 按页码查（查第10页的所有班费收支）
• 按交易号查（查第5号缴费记录的详情）
• 按日期查（查9月份的所有支出记录）

QSCC不修改账本数据，仅提供只读查询服务，确保任何节点都能便捷地验证和追溯交易。其查询结果直接来自区块链的底层存储（区块文件和状态数据库），保证数据的真实性和一致性。

（二）与班费管理的类比关系

QSCC核心概念	班费管理场景类比	作用说明
区块（Block）	账本的一页纸	记录一定时间内的多笔班费交易
交易（Transaction）	单笔班费记录	如"张三缴纳50元"或"购买文具支出30元"
区块号（BlockNumber）	账本页码	按时间顺序编排（第1页、第2页…）
交易ID（TxID）	交易编号	每笔记录的唯一标识（如"20230901-001"）

二、GetBlockByNumber()方法：按页码查询账本的"某一页内容"

（一）原理与功能

GetBlockByNumber()方法用于按区块号查询指定通道的完整区块数据，返回该区块包含的所有交易、区块头（时间戳、前序哈希等）和区块元数据。它就像班级同学想查看"班费总账本第5页"的内容——这一页可能记录了9月5日当天的3笔交易：李四缴费50元、王五缴费50元、购买垃圾袋支出10元。

GetBlockByNumber()的核心功能：

1. 接收通道ID和区块号作为参数（如"class-3-2"通道，第5块）
2. 验证查询者是否有权限访问该通道数据
3. 从节点本地区块存储中读取对应区块的完整数据
4. 返回区块的结构化信息（区块头、交易列表、元数据）

（二）班费场景类比

财务委员需要核对9月5日的班费交易：

1. 记得9月5日的记录在账本第5页（区块号=5）
2. 向QSCC发起查询：“请返回class-3-2通道第5块数据”（调用GetBlockByNumber(“class-3-2”, 5)）
3. QSCC验证财务委员权限后，返回第5页