Hyperledger Fabric 1.4 Node.js链码：如何实现指定范围分页查询

我来帮你梳理下这个问题，Hyperledger Fabric 1.4的Node.js链码里确实没有直接支持offset的分页参数，它的分页机制是基于**bookmark（游标）**的——也就是以上一页最后一条记录的key作为下一页的起始标记，而不是传统的偏移量。要获取第90-100条记录，我们可以通过两次查询来模拟offset的效果，具体思路和代码实现如下：

核心原理 #

要拿到第90-100条记录，本质上是要先定位到第89条记录的位置（作为起始游标），再从这个位置开始查询10条数据。Fabric的分页方法getQueryResultWithPagination和getStateByRangeWithPagination都支持通过bookmark参数传入上一页最后一条记录的key，以此作为下一页的查询起点。

代码实现（基于getQueryResultWithPagination） #

如果你的数据是通过CouchDB富查询获取的，可以用以下代码模拟offset+limit：

// 辅助函数：遍历迭代器获取所有结果
async function getAllResults(iterator) {
    let allResults = [];
    let res = await iterator.next();
    while (!res.done) {
        if (res.value && res.value.value.toString()) {
            let jsonRes = {
                Key: res.value.key,
                Record: JSON.parse(res.value.value.toString('utf8'))
            };
            allResults.push(jsonRes);
        }
        res = await iterator.next();
    }
    await iterator.close();
    return allResults;
}

// 主函数：获取指定offset和limit的记录
async function getRecordsByOffset(ctx, queryStr, offset, limit) {
    let bookmark = "";
    
    // 第一步：获取到offset位置对应的bookmark（即前offset条的最后一条key）
    if (offset > 0) {
        const preIterator = await ctx.stub.getQueryResultWithPagination(queryStr, offset, bookmark);
        const preResults = await getAllResults(preIterator);
        
        // 如果总记录数不足offset，直接返回空数组
        if (preResults.length < offset) {
            return [];
        }
        // 把最后一条记录的key作为下一页的bookmark
        bookmark = preResults[preResults.length - 1].Key;
    }
    
    // 第二步：用bookmark查询limit条数据
    const finalIterator = await ctx.stub.getQueryResultWithPagination(queryStr, limit, bookmark);
    return await getAllResults(finalIterator);
}

// 调用示例：获取第90-100条记录（offset=89，limit=10）
// const query = '{"selector": {}}'; // 替换为你的实际查询条件
// const targetRecords = await getRecordsByOffset(ctx, query, 89, 10);

代码实现（基于getStateByRangeWithPagination） #

如果是按key范围查询数据，逻辑类似，只是替换成范围查询的方法：

async function getStateRangeByOffset(ctx, startKey, endKey, offset, limit) {
    let bookmark = "";
    
    if (offset > 0) {
        const preIterator = await ctx.stub.getStateByRangeWithPagination(startKey, endKey, offset, bookmark);
        const preResults = await getAllResults(preIterator);
        
        if (preResults.length < offset) {
            return [];
        }
        bookmark = preResults[preResults.length - 1].Key;
    }
    
    const finalIterator = await ctx.stub.getStateByRangeWithPagination(startKey, endKey, limit, bookmark);
    return await getAllResults(finalIterator);
}

// 调用示例：获取key范围内的第90-100条记录
// const targetRecords = await getStateRangeByOffset(ctx, "key001", "key999", 89, 10);

注意事项 #

1. 性能考量：如果offset很大（比如几千条），第一次查询会遍历大量数据，可能影响链码性能。这种情况下建议优化查询条件，或者确保CouchDB的索引配置正确，提升分页效率。
2. 数据一致性：两次查询之间如果有数据插入/删除，可能导致结果偏移。如果需要强一致性，可以将两次查询放在同一个事务中执行。
3. bookmark的有效性：bookmark必须是上一次查询返回的最后一条记录的key，不能手动构造，否则会导致查询异常。

内容的提问来源于stack exchange，提问作者Brajesh Singh