Spring Data Elasticsearch中@Field(type=Keyword)注解失效问题排查

以下是可能导致@Field(type=FieldType.Keyword)注解不生效、字段被识别为text类型的常见原因：

• 依赖版本不兼容：spring-boot-starter-data-elasticsearch 3.2.4适配的是Elasticsearch 7.x版本，而你使用的ES服务端是6.8.6，跨大版本的客户端与服务端存在映射逻辑差异，会导致注解配置无法被正确解析。

• 索引映射未更新：如果在修改实体类注解前，目标索引已创建且字段被设为text类型，ES默认不允许修改已有字段的类型（新增字段除外）。此时即使修改注解，旧索引的映射也不会自动更新，需要删除旧索引重新创建，或手动调整映射并重新索引数据。

• 注解导入错误或配置冲突：检查是否正确导入org.springframework.data.elasticsearch.annotations.Field注解（避免导入其他包的同名类）。另外，若字段继承了父类的text类型配置，或存在重复注解覆盖当前配置，也会导致keyword类型不生效。

• 自定义配置覆盖注解逻辑：查看项目中的ES配置类，是否存在自定义的ElasticsearchTemplate或映射转换器，这些自定义逻辑可能统一将String类型字段处理为text类型，从而覆盖注解的配置。

• 字段名不匹配：确认实体类字段名与ES中的字段名完全一致，若开启了驼峰转下划线的命名策略，需检查转换后的字段名是否和你查询的字段对应，避免因字段名不一致误以为注解未生效。

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