Solr使用Facet查询时间歇性触发Undefined field异常求助

我看到你这个问题挺典型的——近10万次查询只偶发4次失败，而且字段明明在映射里配置好了，这种偶发问题通常和集群状态、请求路由或者配置一致性有关。先梳理下你提供的关键信息：

• 触发异常：undefined field: "facetfieldname"
• 核心查询参数：

q=tenantid:"value"+AND+appinstid:"value"+AND+status:"Open"&shard.shuffling.strategy=SEED&shard.shuffling.seed=value&terms=true&rows=0&start=0&facet.field=facetfield&facet=true&facet.limit=-1&facet.mincount=0&facet.offset=0

• 字段配置：已在Solr映射XML中定义

<field name="facetfieldname" type="string" indexed="true" stored="true" />

• 环境：DSE 4.8.9（集成Solr）、SolrJ 4.8.0

下面是几个重点排查方向：

1. 先确认字段名的一致性（是否存在偶发笔误） #

你提供的查询语句里facet.field的值是facetfield，但异常提示的不存在字段是facetfieldname，映射里的字段名也是facetfieldname，这里的差异要重点确认：

• 检查代码中组装查询参数的逻辑，是不是存在某种偶发错误（比如分支逻辑异常），导致极少数情况下把字段名写成了facetfield而非正确的facetfieldname；
• 提取失败请求的完整日志，确认实际发送给Solr的facet.field参数值到底是什么，是否真的存在偶发的字段名错误。

2. 检查Solr分片的Schema配置一致性 #

因为你的查询用到了分片策略（shard.shuffling.strategy=SEED），很可能是某个分片的Schema没有同步更新，导致该分片上不存在目标字段：

• 登录到每个Solr节点，检查对应Collection的schema.xml，确认facetfieldname字段在所有分片的配置中都存在；
• 如果是DSE集成的Solr，确认执行过dse solr reload <keyspace.table>命令，并且所有节点都成功加载了新的Schema配置；
• 查看Solr节点的日志，有没有某个分片加载Schema失败的记录。

3. 排查请求路由的异常 #

shard.shuffling.strategy=SEED会根据指定的seed值选择对应的分片，偶发失败可能和特定分片有关：

• 记录失败请求的shard.shuffling.seed值，看看是否每次失败都对应同一个seed（也就是同一个分片）；
• 直接向可疑分片单独发送查询请求，验证是否会稳定抛出undefined field异常，确认该分片的配置问题。

4. 检查SolrJ客户端的请求处理逻辑 #

你使用的SolrJ 4.8.0是比较老的版本，可能存在客户端层面的参数篡改或重试异常：

• 检查SolrClient.executeQuery和runQuery方法的代码，有没有在重试、异步执行过程中错误修改了facet.field参数；
• 查看客户端日志，确认失败请求的参数是否完整且正确，排除客户端层面的参数异常。

5. 排查DSE Solr特有的集群问题 #

作为DSE集成的Solr，有些DSE专属的问题可能导致这种偶发现象：

• 检查DSE节点在失败时间段内的状态，有没有节点出现重启、网络波动或离线情况？如果某个分片节点临时不可用，请求可能被路由到未同步Schema的备用节点；
• 确认DSE的Solr Schema自动同步功能是否正常，是否存在Schema同步延迟的情况。

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