Solr6插入/更新文档未定义字段报错问题及解决咨询

Solr 6 开始默认启用了 enforceFields 配置项（默认值为true），该参数会强制校验所有写入的字段必须在Schema中预先定义。而在 Solr 5 及更早版本中，enforceFields 默认值为false，未在Schema中定义的字段会被自动忽略，不会触发错误。

以下是几种可行的解决方案，可根据业务需求选择：

1. 关闭字段强制校验 #

修改目标集合的solrconfig.xml，在updateHandler配置块中添加或修改enforceFields参数为false：

<updateHandler class="solr.DirectUpdateHandler2">
  <str name="enforceFields">false</str>
</updateHandler>

修改完成后重启Solr节点，即可恢复Solr5的行为——未定义字段会被自动忽略，不再报错。

2. 配置动态字段（推荐方案） #

如果希望保留字段校验的严谨性，同时兼容未知字段，可以在Schema中配置动态字段规则，匹配可能出现的未定义字段。例如：

• 匹配所有以ACCT_开头的字段：

<dynamicField name="ACCT_*" type="string" indexed="false" stored="true"/>

• 匹配所有未定义的通用字段：

<dynamicField name="*" type="string" indexed="false" stored="true"/>

符合规则的未知字段会被自动映射到对应的动态字段类型，既不会报错，也能按需存储或索引字段内容。

3. 在代码层过滤无效字段 #

在向Solr写入文档前，先获取目标集合的Schema字段列表，过滤掉文档中不存在于Schema的字段。示例Java代码：

// 获取目标集合的Schema字段集合
SolrSchema schema = client.getSchema("your_collection_name");
Set<String> validFieldNames = schema.getFields().stream()
    .map(SolrField::getName)
    .collect(Collectors.toSet());

// 构建过滤后的Solr文档
SolrInputDocument validDoc = new SolrInputDocument();
// 假设原始数据存储在rawData Map中
Map<String, Object> rawData = ...;
rawData.forEach((fieldName, value) -> {
    if (validFieldNames.contains(fieldName)) {
        validDoc.addField(fieldName, value);
    }
});

// 提交到Solr
client.add("your_collection_name", validDoc);
client.commit();

4. 使用Update Processor自动处理未知字段 #

通过配置Solr的Update Processor链，自动移除或重命名未定义的字段。在solrconfig.xml中添加如下配置：

<!-- 定义移除未知字段的处理器 -->
<updateProcessor name="removeUnknownFields" class="solr.FieldNameMutatingUpdateProcessorFactory">
  <str name="pattern">.*</str>
  <str name="replacement"/>
  <bool name="ignoreMissing">true</bool>
</updateProcessor>

<!-- 绑定到更新请求处理器 -->
<requestHandler name="/update" class="solr.UpdateRequestHandler">
  <lst name="defaults">
    <str name="update.chain">removeUnknownFields</str>
  </lst>
</requestHandler>

配置后，所有写入请求会自动移除未在Schema中定义的字段，无需修改业务代码。

内容的提问来源于stack exchange，提问作者World of Titans