Hybris新增de_DE语言Solr索引报spellcheck_de_DE未知字段错误

在Hybris平台新增de_DE语言后执行Solr索引操作触发运行异常，初始错误提示为索引文档[doc=productCatalog/Online/product_code]存在未知字段spellcheck_de_DE，完整异常堆栈如下：

Caused by: org.apache.solr.client.solrj.impl.HttpSolrClient$RemoteSolrException: Error from server at http://localhost:8983/solr: ERROR: [doc=productCatalog/Online/productCode] unknown field 'spellcheck_de_DE'
at org.apache.solr.client.solrj.impl.HttpSolrClient.executeMethod(HttpSolrClient.java:681) ~[solr-solrj-8.6.3.jar:8.6.3 e001c2221812a0ba9e9378855040ce72f93eced4 - jasongerlowski - 2020-10-03 18:12:06]
at org.apache.solr.client.solrj.impl.HttpSolrClient.request(HttpSolrClient.java:266) ~[solr-solrj-8.6.3.jar:8.6.3 e001c2221812a0ba9e9378855040ce72f93eced4 - jasongerlowski - 2020-10-03 18:12:06]
at org.apache.solr.client.solrj.impl.HttpSolrClient.request(HttpSolrClient.java:248) ~[solr-solrj-8.6.3.jar:8.6.3 e001c2221812a0ba9e9378855040ce72f93eced4 - jasongerlowski - 2020-10-03 18:12:06]
at de.hybris.platform.solrfacetsearch.solr.impl.SolrStandaloneSearchProvider$ClusterSolrClient.request(SolrStandaloneSearchProvider.java:503) ~[solrfacetsearchserver.jar:?]
at de.hybris.platform.solrfacetsearch.solr.impl.CachedSolrClient.request(CachedSolrClient.java:64) ~[solrfacetsearchserver.jar:?]
at org.apache.solr.client.solrj.SolrRequest.process(SolrRequest.java:214) ~[solr-solrj-8.6.3.jar:8.6.3 e001c2221812a0ba9e9378855040ce72f93eced4 - jasongerlowski - 2020-10-03 18:12:06]
at org.apache.solr.client.solrj.SolrClient.add(SolrClient.java:106) ~[solr-solrj-8.6.3.jar:8.6.3 e001c2221812a0ba9e9378855040ce72f93eced4 - jasongerlowski - 2020-10-03 18:12:06]
at org.apache.solr.client.solrj.SolrClient.add(SolrClient.java:71) ~[solr-solrj-8.6.3.jar:8.6.3 e001c2221812a0ba9e9378855040ce72f93eced4 - jasongerlowski - 2020-10-03 18:12:06]
at de.hybris.platform.solrfacetsearch.indexer.impl.SolrServerExporter.exportToUpdateIndex(SolrServerExporter.java:83) ~[solrfacetsearchserver.jar:?]
at de.hybris.platform.solrfacetsearch.indexer.impl.DefaultIndexer.indexItems(DefaultIndexer.java:213) ~[solrfacetsearchserver.jar:?]
at de.hybris.platform.solrfacetsearch.indexer.strategies.impl.DefaultIndexerBatchStrategy.executeIndexerOperation(DefaultIndexerBatchStrategy.java:245) ~[solrfacetsearchserver.jar:?]
at de.hybris.platform.solrfacetsearch.indexer.strategies.impl.DefaultIndexerBatchStrategy.execute(DefaultIndexerBatchStrategy.java:210) ~[solrfacetsearchserver.jar:?]
at de.hybris.platform.solrfacetsearch.indexer.workers.impl.DefaultIndexerWorker.doRun(DefaultIndexerWorker.java:195) ~[solrfacetsearchserver.jar:?]
at de.hybris.platform.solrfacetsearch.indexer.workers.impl.DefaultIndexerWorker.run(DefaultIndexerWorker.java:151) ~[solrfacetsearchserver.jar:?]
at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:515) ~[?:?]
at java.util.concurrent.FutureTask.run(FutureTask.java:264) ~[?:?]
at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:515) ~[?:?]
at java.util.concurrent.FutureTask.run(FutureTask.java:264) ~[?:?]
at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1128) ~[?:?]
at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:628) ~[?:?]
at java.lang.Thread.run(Thread.java:829) ~[?:?]

当前已完成solrconfig.xml与schema.xml的配置校验，确认配置看似符合规范，但仍持续触发该错误。

这类报错核心是Solr服务运行时的字段定义里找不到spellcheck_de_DE字段，配置校验通过但报错的常见原因如下：

• 配置修改后未触发Solr Core重载，Solr运行时加载的还是旧版本配置，没有识别到新增字段
• 修改的配置文件路径错误，改动的是模板目录下的文件，不是业务使用的Solr Core实际加载的配置文件
• 字段规则未覆盖新语言：拼写检查字段仅配置了已有语言的静态字段，没有配置spellcheck_*格式的动态字段兜底，新增de_DE语言后没有自动生成对应字段
• Hybris侧配置未同步：新增语言后没有从Hybris后台导出最新的Solr配置，Hybris索引时写入的字段和Solr侧实际生效的字段不匹配

按以下顺序操作排查修复：

1. 校验Solr实际加载的配置
   • 访问Solr管理后台，选中业务使用的对应Solr Core，进入Schema菜单搜索spellcheck_de_DE，确认字段是否存在。如果搜索不到，说明Solr未加载到正确配置。
   • 核对修改的schema.xml路径，确保改动的是对应Solr Core的conf目录下的生效文件，不是全局模板文件。
2. 补全字段定义
   • 优先配置动态字段兜底，避免后续新增其他语言重复报错，在schema.xml中添加如下配置：

     <dynamicField name="spellcheck_*" type="text_spell" indexed="true" stored="false" multiValued="true"/>
     

   • 如果不需要动态字段规则，可单独添加de_DE对应的静态字段：

     <field name="spellcheck_de_DE" type="text_spell" indexed="true" stored="false" multiValued="true"/>
     

   • 配置前确认text_spell字段类型已在schema中定义，且绑定的分词器适配德语拼写检查场景。
3. 重载Solr配置生效
   • 配置修改完成后，在Solr后台Core Admin菜单选中对应Core，点击Reload按钮重载配置，或直接重启Solr服务。重载完成后回到Schema页面再次确认spellcheck_de_DE字段可被检索到。
4. 同步Hybris侧配置
   • 登录Hybris管理后台，进入Solr facet search配置页面，找到对应商品索引配置，触发导出Solr配置操作，将Hybris侧生成的最新配置同步到Solr服务端。
   • 检查索引字段列表，确认spellcheck_de_DE已在索引字段列表中，字段属性与Solr侧定义完全一致。
5. 执行全量索引
   • 清除旧的异常索引数据后，触发全量索引操作，不要直接运行增量索引，避免旧缓存导致错误复现。

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