ES 6.7 为字段配置同义词分析器时报Failed to install template错误

• ES 6.7 版本的synonym类型分词过滤器不支持updateable参数，该参数是ES 7.3版本才引入的可热更新同义词专属配置，6.7版本解析时会识别为非法参数，直接抛出解析异常，导致整个索引模板安装失败。
• 其余配置项的语法本身符合6.7版本要求，不会直接触发报错，但存在功能实现的细节缺陷：
  • 自定义synonym_analyzer仅配置了whitespace分词器和同义词filter，缺少小写处理逻辑，和原有字段的大小写兼容规则不匹配，容易出现大小写不一致导致的召回失效。
  • 新增的keyword_analyzered_field仅配置了search_analyzer，未指定索引阶段的分析器，虽不影响模板安装，但会导致索引写入阶段走默认的standard分词器，和检索阶段的分词逻辑不匹配，影响同义词检索的召回准确率。
  • 同义词规则以单字符串形式承载，多规则写入场景下易触发解析边界错误，属于稳定性风险点。

关键调整点 #

• 移除同义词过滤器配置中的updateable: true参数，完全匹配6.7版本的语法规则，解决模板安装报错问题。
• 给同义词分析器补充lowercase过滤器，对齐原有字段的大小写处理逻辑，消除大小写差异导致的召回漏失。
• 给新增的同义词检索字段显式指定索引、检索双阶段的分析器，保证写入和检索的分词逻辑一致，提升召回准确率。
• 将同义词规则调整为数组格式承载，避免字符串解析的兼容性问题。

完整可运行配置 #

"settings": {
  "analysis": {
    "normalizer": {
      "lowercase": {
        "type": "custom",
        "filter": ["lowercase"]
      }
    },
    "analyzer": {
      "synonym_analyzer": {
        "tokenizer": "whitespace",
        "filter": ["lowercase", "my_synonyms"]
      }
    },
    "filter": {
      "my_synonyms": {
        "type": "synonym",
        "synonyms": ["piping, plumbing"]
      }
    }
  }
},
"mappings": {
  "doc": {
    "dynamic": "false",
    "properties": {
      "primarytrades": {
        "type": "nested",
        "properties": {
          "name": {
            "type": "text",
            "fields": {
              "keyword": {
                "type": "keyword",
                "ignore_above": 256,
                "normalizer": "lowercase"
              },
              "keyword_analyzered_field": {
                "type": "text",
                "analyzer": "synonym_analyzer",
                "search_analyzer": "synonym_analyzer"
              }
            }
          }
        }
      }
    }
  }
}

• 6.7版本的同义词过滤器不支持热更新，后续如需调整同义词规则，需要手动重建索引完成更新，无在线动态修改能力。
• 配置完成后可通过ES的_analyze接口验证分词效果，确认同义词规则、大小写处理逻辑正常生效。

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