Elasticsearch索引分析器添加synonym_graph过滤器报错排查

你遇到的报错是因为**synonym_graph过滤器仅支持在搜索阶段运行**，Elasticsearch 7.x版本明确禁止将其用于索引分析器。这个过滤器的设计目标是在搜索时生成支持短语匹配的同义词语法结构，索引阶段运行会破坏文档的索引结构，因此被限制使用。

根据你的需求（在索引阶段处理同义词以识别拼写错误），有两种可行方案：

方案1：改用普通synonym过滤器索引同义词 #

如果不需要处理短语同义词，直接将synonym_graph替换为普通的synonym过滤器即可，它支持索引阶段运行：

"filter": {
  "synonyms": {
    "type": "synonym",  // 替换为普通synonym类型
    "synonyms": [
        // 你的同义词规则示例
        "apple, appel, aple => apple",
        "banana, banan, bannana => banana"
    ]
  }
},
"analyzer": {
  "index_analyzer": {
    "tokenizer": "standard",
    "filter": ["lowercase", "synonyms", "edge_ngram"]
  },
  "search_analyzer": {
    "tokenizer": "standard",
    "filter": ["lowercase"]  // 搜索时可根据需求调整是否保留同义词/ngram
  }
}

字段映射保持不变：

"text" : {
  "type" : "text",
  "analyzer": "index_analyzer",
  "search_analyzer": "search_analyzer"
}

这种方式会在索引时就将同义词统一映射为目标词，配合edge_ngram可以实现对同义词拼写错误的模糊匹配。

方案2：将synonym_graph移至搜索分析器 #

如果需要处理短语同义词（比如"new york, nyc"这类短语级同义词），可以保留synonym_graph但仅在搜索阶段使用，索引阶段只做lowercase和edge_ngram处理：

"filter": {
  "synonyms_graph": {
    "type": "synonym_graph",
    "synonyms": [
        // 你的短语同义词规则示例
        "new york, nyc",
        "united states, usa"
    ]
  }
},
"analyzer": {
  "index_analyzer": {
    "tokenizer": "standard",
    "filter": ["lowercase", "edge_ngram"]
  },
  "search_analyzer": {
    "tokenizer": "standard",
    "filter": ["lowercase", "synonyms_graph"]
  }
}

字段映射同样保持不变。这种方式下，文档索引时会生成ngram片段，搜索时先通过synonym_graph处理同义词，再用处理后的搜索词匹配索引中的ngram，同样能实现对同义词拼写错误的模糊识别。

Elasticsearch文档中提到的“含同义词集的分析器可设为索引或搜索分析器”，指的是普通synonym过滤器，而非synonym_graph。synonym_graph的文档明确标注了它是为搜索阶段优化的组件，不支持索引阶段使用。

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