在Solr Cloud模式下自定义字段类型（基于Solr源码）

在Solr Cloud环境中，不能像传统单机模式那样直接修改本地XML文件，需要结合ZooKeeper配置管理和Solr API来操作，具体步骤如下：

1. 确保自定义字段类的Jar包可被所有节点加载 #

把自定义的custom.MyCustomField类打包成Jar后，要么部署到每个Solr节点的server/solr/lib目录下；要么将Jar放到自定义配置集的lib子目录中，后续随配置集一起上传到ZooKeeper。必须保证所有节点都能加载到这个类，否则会出现ClassNotFoundException。

2. 上传包含自定义字段类型的配置集到ZooKeeper #

Solr Cloud的配置文件统一存在ZooKeeper中，你需要先准备好包含自定义字段类型的配置文件（比如managed-schema或schema.xml），比如文件里已经添加：

<fieldType name="terkim" class="custom.MyCustomField"/>
<field name="tapli" type="terkim" indexed="true" stored="true"/>

然后用Solr自带的zkcli工具上传配置集：

./server/scripts/cloud-scripts/zkcli.sh -zkhost <ZK地址:端口> -cmd upconfig -confdir /本地配置文件目录 -confname 自定义配置集名称

上传完成后，这个配置集就会被ZooKeeper统一管理。

3. 新建或更新集合使用目标配置集 #

• 新建集合：通过Solr Admin界面或API创建集合时，指定使用刚才上传的配置集。比如API请求：

http://<Solr节点地址>:8983/solr/admin/collections?action=CREATE&name=目标集合名&numShards=2&replicationFactor=1&configName=自定义配置集名称

• 已有集合更新配置：如果要给已存在的集合添加自定义字段类型，更推荐用Schema API直接修改，无需手动编辑XML。发送POST请求到集合的Schema端点，请求体为JSON：

{
  "add-field-type": {
    "name": "terkim",
    "class": "custom.MyCustomField"
  },
  "add-field": {
    "name": "tapli",
    "type": "terkim",
    "indexed": true,
    "stored": true
  }
}

执行后，Solr会自动把配置同步到所有节点，不用手动操作每个实例。

注意事项 #

• 所有Solr节点必须能访问到自定义类的Jar包，否则字段类型无法正常初始化。
• 如果使用Managed Schema模式，优先用Schema API操作，避免直接编辑XML导致配置不一致。
• 配置集上传到ZooKeeper后，所有关联该配置集的集合都会应用新配置，操作前请确认影响范围。

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