关于Nebula Graph E_OUTDATED_TERM(-3071)错误的咨询

一、E_OUTDATED_TERM(-3071)错误触发时机 #

该错误属于Raft协议层的校验错误，触发场景包括：

• 客户端的写请求（如DELETE、INSERT等）发送到了已过期的旧Leader节点，此时集群已选举出拥有更高任期号的新Leader，旧Leader因任期失效无法再处理写操作。
• 旧Leader失去Leader身份后，仍尝试向集群发送心跳或处理请求，被集群识别为任期过期的无效操作。

二、“收到旧Leader的过期心跳（已选举出新Leader）”的含义 #

在Nebula的Raft集群机制中，每个Leader对应一个单调递增的任期号（Term）：

1. 集群选举出新Leader时，新Leader会使用比旧Leader更高的任期号，宣告自身的合法Leader身份。
2. 若旧Leader因网络分区、节点故障等原因未感知到身份变更，仍会向其他节点发送心跳包。
3. 其他节点收到心跳包后，发现其任期号低于当前集群的有效任期号，就会判定这是过期心跳，触发该错误提示。

三、升级后特定分区报错的排查建议 #

你遇到的“仅操作特定顶点/边（对应分区17）报错，其他操作正常”的情况，大概率是分区17的Raft副本状态在版本升级后出现异常，结合3.0.0版本对Raft协议校验更严格的特性，给出以下排查步骤：

1. 检查目标分区的副本状态
   执行命令查看分区17的Leader、Follower节点信息及任期号：

   SHOW PART 17;
   

   重点确认所有副本的任期号是否一致，Leader节点是否正常在线。

2. 验证节点网络连通性
   检查分区17的所有副本所在Storage节点之间的网络是否正常，排查是否存在网络分区、丢包或延迟过高的情况——网络异常是导致Leader任期不一致的常见诱因。

3. 手动切换分区Leader
   若确认旧Leader仍在响应请求，可手动将分区17的Leader切换到正常节点：

   CHANGE LEADER IN PART 17 TO <目标Storage节点IP>:<端口>;
   

   （端口默认9779，可根据集群配置调整）

4. 查看Storage节点日志
   登录分区17副本所在的Storage节点，查看日志文件（默认路径/usr/local/nebula/logs/storage/storaged.log），搜索E_OUTDATED_TERM或part 17关键词，获取任期冲突的详细信息，定位具体故障节点。

5. 确认升级完整性
   检查所有Storage节点是否都完成3.0.0版本升级并正常重启，避免因部分节点停留在旧版本导致协议不兼容。

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