重启Corda 3.1节点出现“多个同名节点”错误的原因排查

这个错误的核心原因是同一个法定名称（Legal Name）在节点的网络映射缓存中存在多条节点记录，这违反了Corda中一个Legal Name对应唯一节点的设计规则。咱们来拆解下可能的诱因，包括你提到的网络映射服务（NMS）相关情况，以及其他更常见的原因：

一、是否和网络映射服务的注册方式有关？ #

有可能，但并非NMS本身的设计问题，而是异常的重复注册场景导致：

• 节点之前异常关闭（比如强制kill进程），导致NMS没有收到节点的注销通知，残留了旧的NodeInfo条目；当节点重启重新注册后，NMS中就会存在同一Legal Name的两条记录，节点同步NMS数据后本地缓存就会出现重复。
• 极端情况下，节点启动时的并发注册请求可能导致NMS数据库中插入重复的NodeInfo（虽然Corda的NMS有去重逻辑，但旧版本可能存在边界case）。

二、更常见的其他原因 #

实际上，这个错误更多出现在节点本地的持久化缓存中：

• 节点本地PostgreSQL数据库的node_info表中存在重复的Legal Name条目。比如之前节点异常关闭，导致本地缓存没有正确清理；或者手动操作数据库时误插入了重复记录。
• 同一个节点使用相同Legal Name但不同配置（比如不同P2P端口）多次启动，每次启动都生成新的NodeInfo并写入本地缓存，最终积累了重复条目。

三、解决步骤 #

1. 清理节点本地数据库：
   登录节点的PostgreSQL数据库，查询node_info表：

   SELECT * FROM node_info WHERE legal_name = 'O=*****, L=*****, C=**';
   

   删除多余的记录，只保留最新的一条（可以通过update_timestamp或seq_no字段判断新旧）。

2. 检查并清理网络映射服务数据库：
   同样登录NMS的数据库，执行上述查询，清理重复的NodeInfo条目。

3. 规范节点启停流程：
   避免强制kill节点进程，使用Corda提供的stop命令正常关闭节点，确保节点能向NMS发送注销通知。

4. 测试环境重置方案：
   如果是测试环境，可以直接删除节点的本地数据库，重新初始化节点并向NMS注册。

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