Solr Cloud从4.x升级至7.2.1的最优策略咨询

作为常年处理Solr版本升级的开发者，我得先给你提个醒：你的初步思路里直接复制旧集合文件（包括schema）的做法风险很高——毕竟从4.x到7.2.1跨了好几个大版本，Solr的索引格式、配置结构都发生了根本性变化，直接复制大概率会导致集群启动失败或者数据异常。下面给你一套更稳妥的离线升级方案，适配你允许停机的场景：

一、前置准备工作 #

• 全量备份旧集群：
  • 用Solr自带的备份命令备份每个集合：bin/solr backup -c <集合名> -d <备份目录>
  • 同时备份ZooKeeper中的配置集：用ZK客户端工具zkcli.sh执行-cmd get /solr/configs/<旧配置名>，把配置文件导出到本地
  • 备份旧集群的索引文件（solr_home/data/<集合名>目录），留作最坏情况的回滚用
• 部署兼容版本的ZooKeeper：
  • Solr 7.2.1推荐搭配ZooKeeper 3.4.14及以上版本（避免用太老的ZK版本，比如4.x集群可能用的3.3.x，兼容性会有问题）
  • 搭建好新的ZK集群，确保节点间同步正常
• 部署Solr 7.2.1集群：
  • 下载解压Solr 7.2.1安装包，修改每个节点的solr.xml，配置指向新的ZK集群地址
  • 启动新集群，确认ZK连接正常，集群状态健康

二、迁移并适配配置集 #

这一步是核心，不能直接复用旧配置：

• 转换Schema配置：
  • 4.x的schema.xml和7.x的managed-schema（或兼容的schema.xml）差异很大：比如字段类型的定义、默认属性、分词器配置都有变更
  • 如果你想继续用schema.xml而非managed模式，需要在solrconfig.xml中添加配置：<schemaFactory class="ClassicIndexSchemaFactory"/>
  • 把旧schema.xml中的字段、字段类型、复制字段、动态字段等内容逐一迁移到新配置中，注意删除7.x已废弃的属性（比如omitNorms在7.x中部分字段类型已默认处理）
• 调整Solrconfig.xml：
  • 检查并更新请求处理器（requestHandler）、更新处理器（updateHandler）、缓存配置等：比如7.x中/select handler的默认参数有变化，部分旧的cache配置项已被移除
  • 确保索引格式配置兼容：7.x默认用的Codec和4.x不同，不需要手动修改，但要避免在solrconfig中保留4.x特有的Codec配置
• 上传新配置集到ZK：
  • 用bin/zkcli.sh -zkhost <新ZK地址> -cmd upconfig -confname <新配置集名称> -confdir <本地适配后的配置目录>

三、重建索引（关键：不能直接复制旧索引） #

因为4.x和7.x的索引格式不兼容，必须重新生成索引：

• 停机旧集群：确保所有写入操作停止，避免数据不一致
• 选择合适的索引重建方式：
  • 优先方案：从原始数据源（比如数据库）全量导入到新Solr集合，用DataImportHandler或者自定义脚本完成导入，这是最稳妥的方式，能保证索引完全适配7.x格式
  • 备选方案：如果无法从数据源导入，可以通过旧Solr的查询API导出全量数据（比如用q=*:*加上rows参数分批导出），然后用Solr的Bulk API批量写入到新集群，注意控制单批数据量避免内存溢出

四、验证与切换 #

• 索引导入完成后，执行各类查询测试，验证数据完整性、字段映射正确性、查询性能
• 确认新集群运行正常后，将业务应用的Solr服务地址切换到新集群，正式上线

对你初步思路的点评 #

你提到的「通过Collections API重建集合」是可行的，但前提是先完成配置集的适配转换；而「复制旧集合文件」的做法不可取——旧索引文件格式不兼容，旧schema配置在7.x中会引发大量错误，大概率导致集群无法正常启动。

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