SolrJ客户端选择困惑：参考指南与Javadoc指引矛盾

问题核心 #

• SolrJ提供的HTTP客户端选项包含HttpSolrClient和Http2SolrClient
• 官方参考指南标注Http2SolrClient为实验性API，提示其可能随时变更或被移除
• 但IDE及Javadoc明确标记HttpSolrClient已废弃，要求迁移至Http2SolrClient
• 文档与代码注释的指引完全冲突，需Solr团队给出解释

可能原因与当前建议 #

• 文档更新滞后：这是开源项目中常见的情况——代码层面已完成Http2SolrClient的稳定性验证，计划将其作为HTTP客户端的正式替代方案，先标记旧客户端废弃，但官方指南内容尚未同步更新。
• 选型参考：
  • 若项目对API稳定性要求极高，可暂时保留HttpSolrClient，但需密切关注Solr版本更新，因为废弃类最终会被移除。
  • 若项目可接受一定适配成本，建议优先迁移至Http2SolrClient，这是官方未来的主推方案，后续会持续维护优化。
• 反馈渠道：可通过Solr官方Issue系统提交文档与代码不一致的问题，推动团队同步更新指南内容。

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