如何在Java的Solr查询构建器中仅高亮完整短语？

需要让Solr仅高亮完整的查询短语"hello darkness my old friend"，而非短语中的每个单词：

• 当前高亮结果：

  "<em>hello</em> <em>darkness</em> <em>my</em> <em>old</em> <em>friend</em>. <em>hello</em> there."
  

• 期望高亮结果：

  "<em>hello darkness my old friend</em>. hello there."
  

最小可复现示例 #

import org.apache.solr.client.solrj.SolrQuery;

String query = "hello darkness my old friend";
SolrQuery q = new SolrQuery(query);
q.setHighlightSimplePre("<em>");
q.setHighlightSimplePost("</em>");
String[] queryArray = query.split(" ");

已尝试但无效的配置 #

q.setHighlightFragsize(query.length());
q.set("hl.usePhraseHighlighter", true);
q.set("hl.useFastVectorHighlighter", true);
q.setTermsMinCount(queryArray.length);
q.set("hl.multiTermQuery", true);

注：对于布尔值参数如usePhraseHighlighter，已尝试传入字符串类型的"true"，仍无效果。

正确的Java实现代码 #

核心解决逻辑：将查询包装为短语查询，同时配置高亮参数确保仅匹配完整短语高亮。

import org.apache.solr.client.solrj.SolrQuery;

String queryPhrase = "hello darkness my old friend";
// 把查询内容用双引号包裹，标记为短语查询
SolrQuery q = new SolrQuery("\"" + queryPhrase + "\"");

// 基础高亮标签配置
q.setHighlightSimplePre("<em>");
q.setHighlightSimplePost("</em>");
// 指定需要高亮的目标字段（替换为你实际使用的字段名，比如"content"）
q.addHighlightField("your_target_field");

// 关键高亮参数设置
q.set("hl.usePhraseHighlighter", true);
// 关闭单个词项的独立高亮，强制仅高亮完整短语
q.set("hl.highlightMultiTerm", false);

// 若使用FastVectorHighlighter，需确保字段在schema中配置了termVectors等属性（可选）
// q.set("hl.useFastVectorHighlighter", true);

额外注意事项 #

1. 必须用双引号包裹查询字符串，否则Solr会将其拆分为多个独立词项的OR查询，导致单个词被高亮
2. hl.highlightMultiTerm设为false是核心，它会阻止Solr对短语内的单个词单独高亮
3. 若启用FastVectorHighlighter，目标字段需在schema.xml中配置：

   <field name="your_target_field" type="text_general" indexed="true" stored="true" termVectors="true" termPositions="true" termOffsets="true"/>
   

内容的提问来源于stack exchange，提问作者Marco Frag Delle Monache