复用Document类时如何控制Elasticsearch的_id且不生成id字段？

方案1：在子类重写getId()方法并添加注解（推荐） #

由于无法修改公司库中的Document父类，我们可以通过在子类的getter方法上添加ES注解来规避字段冲突，同时实现自定义_id并移除多余的id字段：

代码示例 #

父类（不可修改）

public class Document {
    private String id;
    // 其他业务字段及对应的getter/setter

    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }
}

子类实现

import org.springframework.data.elasticsearch.annotations.Document;
import org.springframework.data.elasticsearch.annotations.Id;
import org.springframework.data.annotation.Transient;

@Document(indexName = "your_index_name") // 指定ES索引名
public class ElasticDocument extends Document {

    // 重写父类的getId方法，添加ES注解
    @Override
    @Id // 标记该方法返回值对应ES文档的_id
    @Transient // 阻止ES将该字段作为普通文档字段存储
    public String getId() {
        return super.getId();
    }

    // 保持setId方法与父类一致，确保id值正常传入
    @Override
    public void setId(String id) {
        super.setId(id);
    }
}

原理说明 #

• @Id作用在getter方法上，Spring Data ES会将返回值作为ES文档的_id，替代自动生成的ID。
• @Transient会让ES忽略这个字段的普通存储，解决“文档中存在多余id字段”的问题。
• 子类仅重写方法而非重新定义字段，完全规避了父子类字段冲突的报错。

方案2：自定义实体回调（备选） #

如果需要更复杂的ID生成逻辑，可通过Spring Data ES的BeforeConvertCallback接口在持久化前手动处理：

import org.springframework.data.elasticsearch.core.mapping.BeforeConvertCallback;
import org.springframework.stereotype.Component;

@Component
public class DocumentIdCallback implements BeforeConvertCallback<Document> {

    @Override
    public Document onBeforeConvert(Document entity, String index) {
        // 自定义生成ID逻辑，比如用实体的唯一业务字段作为_id
        String customId = entity.getId();
        // 若要移除文档中的id字段，需配合序列化过滤（如在子类给父类id字段加@JsonIgnore）
        return entity;
    }
}

此方案需额外配置序列化过滤，复杂度高于方案1，仅作为特殊场景的备选。

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