Spring Data Elasticsearch标注@Nested字段查询提示非嵌套类型问题排查

这个问题的核心原因是ES中已存在的offer索引的映射没有按注解更新，offersTranslations字段实际还是默认的Object类型，不是你指定的Nested类型，具体可分为以下几种常见场景：

• 索引提前创建：你添加@Field(type = FieldType.Nested)注解之前，offer索引就已经在ES中创建完成了。Spring Data Elasticsearch默认不会主动覆盖已存在的索引映射，新增的注解不会自动同步到已有索引，就会出现代码注解和实际索引映射不一致的问题。
• 自动映射配置未开启：如果你项目中关闭了Spring Data ES的自动索引映射配置，比如配置了spring.data.elasticsearch.repositories.auto-create-index = false，实体类的字段注解就不会生效。
• 注解导包错误：误导入了javax.persistence.Field而非Spring Data ES专属的org.springframework.data.elasticsearch.annotations.Field注解，不过从你贴的代码来看这个概率极低。
• 版本兼容问题：部分旧版本的Spring Data Elasticsearch存在对Set类型的Nested字段识别异常的bug，也会导致映射不生效。

你提到普通查询可以正常访问offersTranslations.language.code是正常现象：Object类型的数组在ES中会被扁平存储，单独查询某个字段不受影响，只是如果你需要做「同一个OfferTranslation对象同时满足多个条件」的查询（比如同一条翻译的title含某关键词、language是某个值），普通查询会出现命中结果不符合预期的问题，只有Nested类型才能保证嵌套对象的字段关联关系。

1. 可接受数据清空的场景：直接删除ES中已有的offer索引，重启服务后Spring Data ES会自动按照实体类注解重新生成正确的映射，Nested查询即可正常运行。
2. 不可删除索引的场景：手动调用ES的更新映射接口，手动将offersTranslations字段类型修改为Nested，之后重建索引迁移历史数据即可。
3. 排查项目配置，确认spring.data.elasticsearch.repositories.auto-create-index配置为true，保证自动映射功能正常开启。
4. 如果你用的Spring Data ES版本低于4.0，建议升级到最新稳定版，避免框架本身的bug影响。

内容的提问来源于stack exchange，提问作者Aymane EL Jahrani