@CompletionField注解未在Elasticsearch映射中生成对应字段问题

核心原因 #

1. 版本不兼容：Spring Data Elasticsearch 4.4.2 官方兼容的 Elasticsearch 版本是 7.17.x，你使用的 Elasticsearch 8.6.0 版本超出兼容范围，会导致注解解析、映射生成等逻辑异常。
2. 索引映射未更新：若索引是在未添加suggest字段前创建的，Spring Data Elasticsearch 默认不会自动更新已存在的索引映射，仅会在首次创建索引时根据实体类注解生成完整映射。
3. suggest字段未赋值：创建文档时如果suggest字段为空，Elasticsearch 的动态映射机制不会自动生成completion类型的字段映射。

解决方案 #

方案一：修正版本兼容性 #

将 Spring Data Elasticsearch 升级到 5.x 版本（对应兼容 Elasticsearch 8.x），或者将 Elasticsearch 降级到 7.17.x，确保两者版本匹配。

方案二：重新生成索引映射 #

1. 删除旧索引：
   通过 Elasticsearch 命令行或 Kibana Dev Tools 执行：

   DELETE /dummy
   

2. 配置自动创建索引：
   在实体类的@Document注解中添加createIndex = true参数，确保应用启动时框架根据实体类注解自动生成完整索引映射：

   @Document(indexName = ESUtil.INDEX_NAME, createIndex = true)
   public class Person {
       // ... 其他字段
       @CompletionField
       private Completion suggest;
       // getters-setters...
   }
   

3. 重启应用：框架会自动创建包含suggest字段的索引映射。

方案三：手动更新索引映射 #

若无法删除旧索引，可手动添加suggest字段的映射：
通过 Kibana Dev Tools 执行：

PUT /dummy/_mapping
{
  "properties": {
    "suggest": {
      "type": "completion"
    }
  }
}

方案四：确保suggest字段正确赋值 #

创建文档时必须给suggest字段赋值，示例代码：

Person person = new Person();
person.setId("1");
person.setName("John");
person.setSurname("Doe");
person.setAge(30);
person.setJob("Engineer");

// 初始化自动补全字段，设置待补全的输入值
Completion suggest = new Completion();
suggest.setInput(Arrays.asList(person.getName(), person.getSurname(), person.getJob()));
person.setSuggest(suggest);

// 保存文档
createOrUpdateDocument(person);

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