Hibernate Search自定义FieldBridge新增字段搜索时无法识别如何解决

问题根因 #

两个报错存在明确因果关系，核心逻辑如下：

• Hibernate Search运行时需要提前掌握所有可搜索字段的元数据，默认不会自动扫描FieldBridge内部动态创建的字段，所以直接搜索date.day这类动态字段时会抛出「找不到字段」的异常。
• 你给三个动态字段手动加@Field注解后，每个@Field都会触发一次桥接器的set方法，等于三次调用DateSplitBridge的set逻辑，每次都会新增date.year/date.month/date.day三个字段，最终导致同一个字段被重复添加，抛出字段重复的异常。

解决方案 #

方案1（官方推荐）：实现MetadataProvidingFieldBridge接口上报字段元数据 #

这个接口是Hibernate Search专门为动态生成多字段的桥接器设计的，桥接器可以主动向框架上报自己会创建的字段定义，框架会自动把这些字段加入元数据，无需额外加@Field注解，也不会触发重复索引。
修改后的桥接器代码示例：

import org.hibernate.search.bridge.MetadataProvidingFieldBridge;
import org.hibernate.search.bridge.builtin.impl.TwoWayString2FieldBridgeAdaptor;
import org.hibernate.search.engine.metadata.impl.FieldMetadataBuilder;
import org.hibernate.search.engine.metadata.impl.FieldType;

public class DateSplitBridge implements TwoWayFieldBridge, MetadataProvidingFieldBridge {
    private final static TimeZone GMT = TimeZone.getTimeZone("GMT");

    @Override
    public void configureFieldMetadata(String name, FieldMetadataBuilder builder) {
        // 主动上报三个动态字段的元数据，存储、排序规则和addField时的配置保持一致即可
        builder.field(name + ".year", FieldType.STRING)
                .sortable(true)
                .store(org.apache.lucene.document.Field.Store.YES);
        builder.field(name + ".month", FieldType.STRING)
                .sortable(true)
                .store(org.apache.lucene.document.Field.Store.YES);
        builder.field(name + ".day", FieldType.STRING)
                .sortable(true)
                .store(org.apache.lucene.document.Field.Store.YES);
    }

    @Override
    public void set(String name, Object value, Document document, LuceneOptions luceneOptions) {
        // 保留原来的字段添加逻辑不变
        Date date = (Date) value;
        if (date == null) {
            return;
        }
        Calendar cal = GregorianCalendar.getInstance(GMT);
        cal.setTime(date);
        int year = cal.get(Calendar.YEAR);
        int month = cal.get(Calendar.MONTH) + 1;
        int day = cal.get(Calendar.DAY_OF_MONTH);

        luceneOptions.addFieldToDocument(name + ".year", String.valueOf(year), document);
        luceneOptions.addFieldToDocument(name + ".month", month < 10 ? "0" + month : String.valueOf(month), document);
        luceneOptions.addFieldToDocument(name + ".day", day < 10 ? "0" + day : String.valueOf(day), document);
    }

    @Override
    public Object get(String name, Document document) {
        final IndexableField field = document.getField(name);
        return field != null ? field.stringValue() : null;
    }

    @Override
    public String objectToString(Object object) {
        // 搜索时如果传的是数字类型，可在这里做格式兼容
        return object.toString();
    }
}

实体类的注解只要保留原来的写法即可，不要加多余的@Fields配置：

@FieldBridge(impl = DateSplitBridge.class)
private Date date;

这个方案可以同时解决「字段找不到」和「字段重复添加」两个问题，是官方推荐的动态多字段桥接实现方式。

方案2：拆分桥接器逻辑 #

如果不想实现元数据上报接口，也可以把原来的拆分逻辑拆成三个独立的单字段桥接器，分别对应年、月、日，再用@Fields声明三个字段，每个字段绑定对应的桥接器：

// 年桥接器示例，月、日桥接器逻辑类似，只返回对应部分即可
public class DateYearBridge implements TwoWayFieldBridge {
    // 逻辑仅提取日期的年份部分做存储、转换
}

实体类配置：

@Fields({
    @Field(name = "date.year", bridge = @FieldBridge(impl = DateYearBridge.class)),
    @Field(name = "date.month", bridge = @FieldBridge(impl = DateMonthBridge.class)),
    @Field(name = "date.day", bridge = @FieldBridge(impl = DateDayBridge.class))
})
private Date date;

这个方案的缺点是重复代码多，仅适合字段数量少的简单场景。

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