SOFAJRaft 中 CliService 操作 addPeer 时 Connection is null 问题解析

问题现象

在使用 SOFAJRaft 的 CliService 进行 addPeer 操作时，开发者遇到了"Connection is null when do check!"的错误提示。该问题表现为当尝试通过 CliService 向 Raft 集群添加新节点时，系统抛出 RemotingException 异常，提示连接检查时连接对象为空。

错误分析

从错误堆栈来看，问题发生在 Bolt 网络层的连接检查阶段。具体调用链显示：

1. 首先在 DefaultConnectionManager.check() 方法中检测到连接对象为 null
2. 随后通过 RpcClient 的 checkConnection 方法向上抛出异常
3. 最终在 CliServiceImpl.addPeer() 方法中处理失败

值得注意的是，虽然错误提示涉及网络连接问题，但实际上集群节点间的心跳通信是正常的，这表明底层网络连接本身是可用的。

根本原因

经过深入排查，发现该问题与 Java 运行环境版本有关：

1. 当使用 JDK 17 运行时，会出现此连接检查失败的问题
2. 切换回 JDK 1.8 后，相同的代码能够正常工作
3. 这表明问题可能与 JDK 高版本中的某些网络或反射机制变更有关

解决方案

针对此问题，目前推荐的解决方案是：

1. 使用 JDK 1.8：这是经过验证的稳定运行环境
2. 等待框架升级：关注 SOFAJRaft 后续版本对高版本 JDK 的兼容性支持

技术启示

1. 环境兼容性：分布式框架对运行环境有特定要求，升级JDK版本需谨慎
2. 错误诊断：网络相关错误不一定总是真实的网络问题，需要结合日志综合分析
3. 版本验证：在生产环境升级前，应在测试环境充分验证各组件兼容性

最佳实践建议

1. 在 SOFAJRaft 使用场景中，目前推荐使用 JDK 1.8 作为运行环境
2. 对于必须使用高版本JDK的场景，建议：
   • 进行全面测试验证
   • 关注框架官方更新
   • 考虑使用容器化技术隔离运行环境

该案例提醒开发者，在分布式系统开发中，运行环境的选择和验证同样重要，需要将框架版本、JDK版本等纳入统一的技术栈管理范畴。