如何将运行中的Hyperledger Fabric区块链数据迁移至新的Hyperledger Fabric区块链

1. 迁移前预检查与准备 #

• 确认旧网络和新网络的Fabric核心版本差异：如果大版本跨度过大（比如1.4.x迁2.5.x），需要先验证链码逻辑兼容性，避免状态数据反序列化异常
• 暂停旧网络所有链码调用和交易提交，避免迁移过程中产生增量数据，保证迁移前后数据一致性
• 完整备份旧网络所有节点的账本数据、MSP证书、私有数据集合（如果有使用）、链码源码以及排序节点的区块数据
• 确认新网络的节点组织架构、通道配置、MSP证书映射规则：如果新网络要复用旧组织证书，提前将旧组织的根证书导入新网络的通道配置中；如果使用新证书，提前规划好证书映射逻辑

2. 旧网络数据导出 #

2.1 全量状态数据导出（仅迁移最新世界状态，不需要历史交易溯源） #

• 进入旧网络对应通道的peer节点CLI容器，执行peer ledger query -o <排序节点地址> -C <通道名称> --getAllKeys 遍历所有状态键，或者直接调用链码中预先编写的全量数据查询接口，将所有状态键值对以JSON、CSV等结构化格式导出
• 如果使用了私有数据集合，同步导出对应集合的私有状态数据

2.2 全量账本+历史交易导出（需要保留完整交易溯源、区块历史） #

• 从旧网络排序节点或者peer节点导出对应通道的完整区块文件：执行peer channel fetch config config_block.pb -o <排序节点地址> -C <通道名称> 先获取配置块，再执行peer channel fetch 0 <通道名>_block_0.pb -o <排序节点地址> -C <通道名称> 逐块导出从创世块到最新高度的所有区块
• 导出账本的世界状态快照：执行peer snapshot submit request -C <通道名称> -n <快照名称> 生成快照文件后从节点的快照目录导出

3. 新网络数据导入 #

3.1 仅导入最新世界状态的操作流程 #

• 在新网络中创建和旧网络同名的通道，部署和旧网络逻辑一致的链码，确认链码初始化完成可以正常调用
• 编写批量调用脚本，将从旧网络导出的状态键值对，按照链码的写入接口规则，批量提交交易到新网络的对应通道
• 批量写入完成后，随机抽取10%以上的键值对，在新旧网络中分别查询对比值是否完全一致，验证数据正确性

3.2 保留完整历史账本的操作流程 #

• 如果新网络要复用旧网络的通道配置，直接将旧网络导出的创世块作为新网络对应通道的创世块，新网络所有peer节点加入通道后，执行peer channel joinbysnapshot --snapshotpath <导出的旧网络快照路径> 直接基于快照同步账本数据，不需要逐块回放
  注意：快照仅支持同小版本的Fabric网络直接导入，跨版本需要先做格式兼容处理
• 如果新网络的通道配置和旧网络不同，需要先对旧网络的区块文件进行配置修改：替换区块中的组织MSP、排序节点地址等配置信息，再将修改后的区块逐块提交到新网络的排序节点，让新网络节点同步所有区块
• 数据同步完成后，对比新旧网络的区块高度、世界状态哈希值，确认完全一致

4. 迁移后校验与切流 #

• 验证所有链码查询、交易写入功能在新网络中正常运行
• 模拟全量业务场景跑测，确认没有数据不一致、业务报错问题
• 逐步将业务流量从旧网络切到新网络，稳定运行72小时以上再下线旧网络

注意：如果旧网络使用了Fabric CA、服务发现、事件监听等组件，迁移时需要同步调整对应组件的配置，保证新网络的服务访问逻辑和旧网络兼容

内容的提问来源于stack exchange，提问作者Aya Elhawary