SolrJ CloudSolrClient连接错误：SolrCloud索引操作故障求助

嘿，我之前折腾SolrCloud连接的时候也踩过几乎一模一样的坑，咱们来逐一排查可能的问题：

1. 最关键的错误：CloudSolrClient的初始化方式不对 #

你当前的代码是直接指定单个Solr节点的Collection URL，但SolrCloud模式下，CloudSolrClient需要连接ZooKeeper来发现整个集群的状态，而不是直接连单个节点的Collection地址。

正确的初始化代码应该是这样的：

// 替换为你的ZooKeeper集群地址列表，本地单节点ZooKeeper就是localhost:2181
List<String> zkHosts = List.of("localhost:2181");
// 初始化CloudSolrClient，指定ZooKeeper地址，再设置默认操作的Collection
SolrClient client = new CloudSolrClient.Builder(zkHosts)
    .setDefaultCollection("collectionname") // 这里注意你的Collection名称拼写是否正确
    .build();

2. 检查Collection名称是否拼写错误 #

你代码里的collectioname少了一个n（应该是collectionname），拼写错误会导致Solr找不到对应的集合，也会触发这个异常。先确认Solr Admin的Cloud页面里确实存在这个名称的Collection。

3. 确认SolrCloud集群和ZooKeeper都正常运行 #

• 先访问Solr Admin页面：http://localhost:8983/solr，切换到Cloud标签，查看集群状态是否正常，所有节点是否在线，目标Collection是否存在。
• 检查ZooKeeper服务状态：用命令zkServer.sh status（Linux/macOS）或zkServer.cmd status（Windows）确认ZooKeeper已经启动，SolrCloud依赖ZooKeeper来管理集群元数据，ZooKeeper挂了集群就无法正常工作。

4. 验证网络连通性和端口权限 #

• 确保你的应用能访问ZooKeeper的默认端口（2181）和Solr节点的端口（8983），没有防火墙、安全组或者代理拦截。可以用telnet localhost 2181或者nc -zv localhost 2181来测试连通性。

5. 检查SolrJ和Solr集群版本是否完全匹配 #

版本不兼容是很多SolrJ连接问题的根源，比如你用SolrJ 9.x连接Solr 8.x的集群，就会出现各种奇怪的初始化异常。请确保你的项目依赖的SolrJ版本和Solr集群的版本完全一致。

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