Elasticsearch 6.2创建索引：添加过滤器与映射及配置丢失排查

根据你描述的情况——映射生效但同义词、停用词等过滤器配置丢失，我在处理ES 6.x相关问题时遇到过不少类似案例，主要原因集中在以下几个方面，给你逐一分析：

1. 最常见：Analysis配置缺少过滤器的具体定义 #

你在analyzer里引用了synonym、stop_words、stop_words_user这些过滤器，但如果没有在analysis.filter节点下明确定义每个过滤器的类型和参数，ES会因为找不到对应的过滤器实现，直接忽略整个analysis配置块（或者仅保留能解析的部分），这是最容易踩的坑。

举个正确的配置结构示例，你需要把每个过滤器的具体配置补上：

{
  "settings": {
    "index": {
      "number_of_shards": 1,
      "analysis": {
        // 必须先定义所有要用到的过滤器
        "filter": {
          "synonym": {
            "type": "synonym",
            // 可以用文件路径或直接写同义词数组
            "synonyms": ["iphone, apple phone", "pc, computer"]
          },
          "stop_words": {
            "type": "stop",
            "stopwords": "_english_" // 用内置停用词表
          },
          "stop_words_user": {
            "type": "stop",
            "stopwords": ["foo", "bar", "test"] // 用户自定义停用词
          },
          "synonym_u": {
            "type": "synonym",
            "synonyms_path": "analysis/user_synonyms.txt" // 从文件加载同义词
          }
        },
        // 再定义分析器，引用上面的过滤器
        "analyzer": {
          "synonym": {
            "tokenizer": "standard",
            // 注意过滤器顺序：一般先转小写，再处理停用词，最后同义词
            "filter": ["lowercase", "stop_words", "stop_words_user", "synonym", "synonym_u"]
          }
        }
      }
    }
  },
  "mappings": {
    // 你的映射配置
  }
}

2. JSON配置存在语法错误或截断 #

你提供的配置里有"synonym_u...的内容"，看起来是被截断了。如果实际配置中存在未闭合的引号、缺失的逗号、括号不匹配等问题，ES解析settings时会失败，自动忽略无效的analysis部分，只保留能正常解析的映射配置。

解决方法：用JSON校验工具（比如本地的jq命令）检查配置的语法完整性，确保没有格式错误。

3. 索引创建时机错误：事后更新settings不生效 #

ES 6.x版本中，已创建的索引不允许修改analysis相关配置（比如添加新的分析器、过滤器）。如果你是先创建了索引（不带这些过滤器配置），之后再尝试通过PUT /_settings更新，这些过滤器配置是不会生效的。

解决方法：删除旧索引，用包含完整analysis配置的settings重新创建索引。

4. 过滤器参数错误导致初始化失败 #

比如同义词过滤器的synonyms_path指向的文件不存在、停用词格式错误，或者过滤器类型写错（比如把synonym写成synonyms），都会导致过滤器初始化失败，ES可能会静默忽略这个无效配置。

排查方法：查看ES的集群日志（默认路径logs/elasticsearch.log），里面会有过滤器初始化失败的具体错误信息，根据日志提示修正参数。

快速排查步骤 #

1. 先校验你的JSON配置语法是否完整正确；
2. 确认analysis.filter下是否定义了所有analyzer中引用的过滤器；
3. 检查ES日志，看是否有analysis相关的错误警告；
4. 确认是在创建索引时就指定了完整的settings，而不是事后更新。

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