为什么Solr中multiValued=False的copyField会返回多值？

问题背景 #

我的Solr Schema配置如下：

<field name="mfName_ntk_cs" type="wc_keywordText" indexed="true" stored="true" multiValued="false" />

...
<copyField source="mfName" dest="mfName_ntk_cs" />

对应的字段类型定义在schema-field-types.xml中：

<fieldType name="wc_keywordText" class="solr.TextField" sortMissingLast="true" omitNorms="true">
  <analyzer>
    <tokenizer class="solr.KeywordTokenizerFactory" />
    <filter class="solr.TrimFilterFactory" />
  </analyzer>
</fieldType>

当我向/update?commit=true提交如下JSON文档时：

[{
  ...
  "mfName": "Some Cool Corp",
  "mfName_ntk_cs": "Some Fake Corp",
  ...
}]

通过/select查询返回的结果里，明明设置了multiValued="false"的mfName_ntk_cs字段却出现了多值：

"mfName_ntk_cs": ["Some Cool Corp", "Some Fake Corp"],

我知道可以避免直接给该字段赋值，但作为Solr新手，在下载JSON文档修改后重新提交时经常碰到这个问题，多次提交后字段会变成多值。想了解是否有办法让Solr拒绝包含mfName_ntk_cs的提交，或者让该字段仅被mfName的值覆盖？

解决方案 #

方法1：设置字段为只读 #

在Schema的mfName_ntk_cs字段定义中添加readOnly="true"属性，这样Solr会拒绝任何直接对该字段的赋值操作，仅允许通过copyField填充值：

<field name="mfName_ntk_cs" type="wc_keywordText" indexed="true" stored="true" multiValued="false" readOnly="true" />

该设置会让Solr在接收到包含该字段的更新请求时直接报错，从根源上阻止手动赋值。

方法2：用更新处理器强制覆盖 #

如果不想完全禁止赋值，而是希望提交时mfName_ntk_cs始终被mfName的拷贝值覆盖，可以配置更新处理器：

1. 在solrconfig.xml中定义字段更新处理器，指定mfName_ntk_cs每次更新时先清空再填充：

<updateProcessor name="overrideMfNameNtkCs" class="solr.FieldMutatingUpdateProcessorFactory">
  <str name="fieldName">mfName_ntk_cs</str>
  <lst name="mutators">
    <str class="solr.SetFieldMutatorFactory">value</str>
  </lst>
</updateProcessor>

2. 将该处理器添加到更新请求链中，确保在copyField执行前完成清空操作，强制字段值被mfName的内容覆盖。

方法3：修改提交逻辑（临时方案） #

如果暂时不想改动Solr配置，可以在提交文档前手动移除JSON中的mfName_ntk_cs字段，只保留mfName，避免手动赋值与copyField操作产生冲突。

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