如何为Elasticsearch别名创建Java实体并获取别名字段值？

你的问题核心在于：Elasticsearch的字段别名仅用于查询时的字段引用，实际存储和返回的文档中仍然使用原始字段名（比如bookId、movieId），而非别名entityId。Spring Data Elasticsearch底层依赖Jackson反序列化文档时，会根据实体属性名匹配返回的字段名，自然找不到entityId对应的字段，导致值为空。

解决方案：用@JsonAlias映射多来源字段 #

通过Jackson的@JsonAlias注解，让实体属性同时匹配两个索引的原始字段名，这样不管是来自books还是movies的文档，都能正确映射到目标属性。

1. 修改Java实体类

@Data
@NoArgsConstructor
@AllArgsConstructor
@Document(indexName = "combined-alias", createIndex = false)
public class Product {

    @Id
    private String uuid;

    // 同时匹配books索引的bookId和movies索引的movieId
    @JsonAlias({"bookId", "movieId"})
    private Long entityId; // 注意：ES中该字段是long类型，实体用Long更匹配，避免类型转换问题

    // 同时匹配books索引的creationDate和movies索引的createDate
    @JsonAlias({"creationDate", "createDate"})
    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd'T'HH:mm:ss.SSSXXX")
    private ZonedDateTime createAt;
}

2. 修正仓库接口的泛型类型

实体的@Id是String类型，仓库的ID泛型需要对应修改：

public interface ProductRepository extends ReactiveElasticsearchRepository<Product, String> {
    Flux<Product> findAll();
}

关键说明 #

• @JsonAlias：允许Jackson在反序列化时，将指定的多个字段名映射到同一个实体属性，完美适配两个索引的不同原始字段名。
• 类型匹配：entityId对应ES中的long类型，实体用Long而非String，避免不必要的类型转换错误。
• 日期反序列化：ES中存储的是text类型的日期字符串，通过@JsonFormat指定格式，确保Jackson能正确将字符串转为ZonedDateTime。

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