如何为已存在的Elasticsearch索引正确配置自定义分析器？

失败原因说明 #

你之前的操作失败有两个核心原因：

1. 分析器属于Elasticsearch的非动态设置，无法直接在开放状态的索引上修改，因此直接调用PUT /index_name/_settings会触发非法参数错误。
2. 目标索引已存在，重复执行PUT /index_name创建索引会触发资源已存在错误。

正确操作步骤 #

1. 关闭目标索引

只有关闭索引后，才能修改非动态的分析器设置：

POST /index_name/_close

2. 更新索引设置，添加自定义分析器

关闭索引后，执行你最初的设置更新请求：

PUT /index_name/_settings
{
  "analysis" : {
    "analyzer":{
      "custom_analyzer_name": {
          "type": "custom", 
          "tokenizer": "standard",
          "char_filter": [
            "html_strip"
          ],
          "filter": [
            "lowercase",
            "stop"
          ]
        }
    }
  }
}

3. 重新打开索引

设置更新完成后，重新打开索引使其生效：

POST /index_name/_open

4. 将自定义分析器绑定到字段（可选但必要）

如果需要让特定字段使用这个新分析器，需要更新字段的映射配置。注意：如果字段已有数据，修改映射后，旧数据不会自动重新分析，需要执行重新索引操作：

PUT /index_name/_mapping
{
  "properties": {
    "your_target_field": {
      "type": "text",
      "analyzer": "custom_analyzer_name"
    }
  }
}

5. 重新索引现有数据（可选）

若要让已存在的文档数据也使用新分析器处理，需要通过_reindex API重新索引数据：

POST _reindex
{
  "source": {
    "index": "index_name"
  },
  "dest": {
    "index": "index_name_new"
  }
}

重新索引完成后，可通过别名切换实现业务无感知：

POST /_aliases
{
  "actions": [
    { "remove": { "index": "index_name", "alias": "index_name" } },
    { "add": { "index": "index_name_new", "alias": "index_name" } }
  ]
}

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