Hazelcast 4.2.1 3节点配置CP子系统Raft报NotLeaderException如何解决

你遇到的Leader N/A警告和NotLeaderException异常是Raft组初始化失败、无法完成Leader选举导致的，可按以下步骤排查修正：

• 修正代码错误：你当前的分布式锁调用缺少必填的锁名称参数，正确调用方式如下：

// 需传入自定义的锁唯一标识，不能调用无参的getLock()
hazelcastInstance.getCPSubsystem().getLock("your-custom-lock-name").lock();

• 确保所有节点CP配置完全一致：3个节点的<cp-subsystem>完整配置块必须完全相同，不能出现cp-member-count、group-size等核心参数不一致的情况，否则Raft集群会直接拒绝初始化。你当前的配置参数取值（3个CP成员、组大小3）符合规则，只要保证三个节点配置完全一致即可。
• 清理历史残留元数据后重启集群：如果之前集群未开启CP子系统就启动过，节点本地会残留旧的集群元数据，干扰CP子系统初始化。需要先停止所有3个节点，清空每个节点工作目录下的持久化目录（默认是hazelcast/work下的所有内容，若自定义了CP持久化路径也一并清空），再同时启动3个节点，启动间隔不要超过你配置的2000ms选举超时时间，避免选举流程中断。
• 排查节点网络连通性：3个节点之间的Hazelcast默认端口（5701-5703）必须双向TCP互通，不能有防火墙、安全组拦截Raft协议报文。如果节点有多网卡，需要在Hazelcast配置中显式指定绑定的网卡地址和集群发现地址，避免节点使用127.0.0.1注册导致跨节点通信失败。
• 可选升级维护版本：Hazelcast 4.2.1存在已知的Raft选举边缘case bug，如果上述步骤都执行完仍有问题，可以升级到4.2分支的最新维护版4.2.8，无需修改业务代码和现有配置即可修复选举异常问题。

如果需要定位更细节的问题，可以将com.hazelcast.cp包的日志级别调整为DEBUG，查看选举过程中的投票、心跳交互日志即可定位具体异常点。

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