SolrJ（v7.3.0）中addFilterQuery失效问题求助

我之前在使用SolrJ 7.x版本时也碰到过类似的filter query不生效的问题，尤其是带{!tag=xxx}局部参数的场景，结合你的描述，给你几个实用的排查和解决方向：

• 先确认FilterQuery是否真的被添加到对象中
  有时候我们以为调用了addFilterQuery就完事了，但可能因为代码逻辑问题（比如不小心重新实例化了SolrQuery对象）导致之前的设置被覆盖。建议在每次调用addFilterQuery之后，立刻打印当前的filter列表，确认参数已经被正确添加：

  SolrQuery query = new SolrQuery();
  query.addFilterQuery("{!tag=style}style:\"winter casual\" OR style:\"formal\"");
  // 打印当前已添加的FilterQueries
  System.out.println("当前FilterQueries: " + Arrays.toString(query.getFilterQueries()));
  

  如果这里能看到你添加的filter，那问题大概率出在后续的代码或者SolrJ的参数传递环节；如果看不到，那就是你的代码里有重置/覆盖SolrQuery的逻辑，得仔细排查。

• 验证带tag的filter语法是否符合SolrJ的处理要求
  手动拼接带局部参数的filter query偶尔会有语法细节问题，比如引号转义。你可以尝试用Solr提供的QueryBuilder来构建filter，避免手动拼接的坑：

  // 用BooleanQuery构建多条件的filter
  BooleanQuery.Builder filterBuilder = new BooleanQuery.Builder();
  filterBuilder.add(new TermQuery(new Term("style", "winter casual")), BooleanClause.Occur.SHOULD);
  filterBuilder.add(new TermQuery(new Term("style", "formal")), BooleanClause.Occur.SHOULD);
  // 给filter添加tag参数后再加入查询
  query.addFilterQuery("{!tag=style}" + filterBuilder.build().toString());
  

  这种方式会让SolrJ自动处理语法转义，减少手动拼接出错的概率。

• 检查版本兼容性与已知bug
  SolrJ 7.3.0属于比较早期的7.x版本，可能存在一些已修复的参数传递bug。建议先确认你的Solr服务端版本和SolrJ版本完全一致（版本不匹配很容易出现参数丢失的情况），如果一致的话，可以考虑升级到7.x系列的稳定版本（比如7.7.3），看看问题是否解决。

• 查看实际发送到Solr的请求参数
  有时候query.toString()的输出可能和实际发送的参数有差异，你可以开启SolrJ的DEBUG日志，查看org.apache.solr.client.solrj包下的日志内容，这样能看到完整的HTTP请求URL和参数，确认fq参数是否真的没有被发送出去。这一步能帮你定位问题是出在SolrJ构建参数的环节，还是请求发送后的服务端处理环节。

• 排查是否有意外清空FilterQuery的操作
  全局搜索一下你的代码，看看有没有调用query.removeFilterQueries()或者query.clear()这类方法，不小心把之前添加的filter都清空了。这类问题很隐蔽，尤其是在复杂的查询构建逻辑里容易出现。

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