Lucene多同义词匹配不符合预期，代码问题排查求助

疑问1：同义词映射是否需要双向添加？ #

Lucene的SynonymMap是单向映射，不具备自动交换性。仅添加(word, synonym)时，只会在索引/查询阶段将word替换为synonym，但不会反向处理synonym到word的转换。如果需要双向匹配（比如搜索note能找到含notes的文档，搜索notes也能找到含note的文档），必须手动添加反向的(synonym, word)映射对。

实际问题：同义词无法全部生效的排查与修复 #

问题根源 #

你的代码当前仅以每行首项为核心，建立它与其他词的单向映射，但没有处理同义词组内所有词的互相映射。以note,notes,notice为例，当前代码只生成了：

• note → notes
• note → notice
  但缺少所有反向及组内交叉映射（如notes → note、notice → notes等）。这导致：
• 索引release notes时，因无notes到note/notice的映射，仅保留notes；
• 索引release notices时，仅保留notice；
• 最终搜索任意一个短语，无法匹配另外两个变体。

代码修复方案 #

1. 修改processLine方法，实现组内全量双向映射

private static void processLine(SynonymMap.Builder builder, String line) {
  boolean keepOrig = Boolean.TRUE;
  String[] terms = line.split(",");
  if (terms.length > 1) {
    // 遍历所有词，两两建立双向映射
    for (int i = 0; i < terms.length; i++) {
      String currentTerm = terms[i].trim();
      for (int j = 0; j < terms.length; j++) {
        if (i == j) continue; // 跳过自身
        String targetTerm = terms[j].trim();
        addPair(builder, currentTerm, targetTerm, keepOrig);
      }
    }
  }
}

2. 优化addPair方法（兼容未来短语扩展）

private static void addPair(SynonymMap.Builder builder, String word, String syn, boolean keepOrig) {
  // 处理word（支持短语拆分）
  CharsRef wordRef = SynonymMap.Builder.join(word.split("\\s+"), new CharsRefBuilder());
  // 处理synonym
  CharsRef synRef = SynonymMap.Builder.join(syn.split("\\s+"), new CharsRefBuilder());
  // 添加正向映射
  builder.add(wordRef, synRef, keepOrig);
}

额外注意事项 #

• 确保LowerCaseFilter在SynonymGraphFilter之前执行，保证所有词统一为小写，与同义词列表格式匹配；
• SynonymGraphFilter的ignoreCase参数设为true是合理的，避免大小写导致的匹配失败；
• 重新索引后用Luke查看，相关位置应同时包含note、notes、notice三个同义词。

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