无法修改实体时，子查询实体ThirdEntity索引更新异常求助

项目中存在无法修改的实体FirstEntity和SecondEntity：

@Entity
@Table(name = "main")
public class FirstEntity {
    @Id
    private Long id;

    @ManyToOne
    private SecondEntity secondaryEntity;
}

@Entity
@Table(name = "secondary")
public class SecondEntity {
    @Id
    private Long id;
    
    private String name;
}

通过@Subselect创建了带索引的自定义实体ThirdEntity，用于基于main表构建索引：

@Indexed
@Entity
@Subselect("select * from main")
public class ThirdEntity {
    @Id
    private Long id;

    @ManyToOne
    private SecondEntity secondaryEntity;

    @Transient
    @GenericField(sortable = Sortable.YES)
    @IndexingDependency(derivedFrom = {
            @ObjectPath(@PropertyValue(propertyName = "secondaryEntity"))
    })
    public String getName() {
        return secondaryEntity.getName();
    }
}

当前问题：当SecondEntity的name字段变更时，ThirdEntity的索引无法自动同步更新，临时方案为使用Hibernate监听器手动重建索引，寻求更优雅的解决办法。

方案1：优化索引依赖路径 #

修改ThirdEntity中getName()方法的@IndexingDependency注解，明确指定索引字段依赖SecondEntity的name属性，让Hibernate Search追踪该字段的变更：

@Transient
@GenericField(sortable = Sortable.YES)
@IndexingDependency(derivedFrom = {
        @ObjectPath({
                @PropertyValue(propertyName = "secondaryEntity"),
                @PropertyValue(propertyName = "name")
        })
})
public String getName() {
    return secondaryEntity.getName();
}

此配置会告知Hibernate Search：ThirdEntity的name索引字段由secondaryEntity.name派生，当SecondEntity的name修改时，自动更新对应ThirdEntity的索引。

方案2：监听关联表变更 #

由于ThirdEntity是基于main表的子查询实体，Hibernate默认不会感知secondary表的变更。通过@Synchronize注解指定需要同步的表，触发ThirdEntity的索引更新：

@Indexed
@Entity
@Subselect("select * from main")
@Synchronize({"main", "secondary"}) // 监听main和secondary表的操作
public class ThirdEntity {
    @Id
    private Long id;

    @ManyToOne
    private SecondEntity secondaryEntity;

    // ... getName()方法
}

当secondary表数据变更时，Hibernate Search会自动识别关联的ThirdEntity实例并重新索引，适合中小数据量场景。

方案3：编程式索引更新（进阶） #

若需要精确控制索引更新范围，可使用Hibernate Search的SearchSession API，在SecondEntity变更时批量更新关联的ThirdEntity索引：

// 在修改SecondEntity的业务逻辑中
SearchSession searchSession = Search.session(entityManager);

// 获取所有关联的ThirdEntity ID
List<Long> thirdEntityIds = entityManager.createQuery(
        "select t.id from ThirdEntity t where t.secondaryEntity.id = :secondaryId", Long.class
)
.setParameter("secondaryId", secondEntity.getId())
.getResultList();

// 批量更新索引
for (Long id : thirdEntityIds) {
    searchSession.indexingPlan().addOrUpdate(searchSession.load(ThirdEntity.class, id));
}

该方案更灵活，避免了全局表监听的性能损耗，适合数据量较大的场景。

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