Spring Boot 3.3.1集成Hibernate Search依赖兼容性问题求助

问题根源 #

你遇到的方法不存在错误，核心是版本兼容冲突：

• Spring Boot 3.3.1默认依赖Hibernate ORM 6.5.2.Final
• 你引入的hibernate-search-orm 5.11.12.Final是基于Hibernate ORM 5.x开发的，它调用的SessionFactoryOptions.getMultiTenancyStrategy()方法在Hibernate ORM 6.x中已被移除/修改，再加上类路径中混入了Hibernate ORM 5.4.33.Final，直接导致类加载混乱。

正确依赖配置方案 #

放弃旧版Hibernate Search 5，改用兼容Hibernate ORM 6的Hibernate Search 6版本（Spring Boot 3.x推荐6.2+）。修改pom.xml中的搜索依赖：

<dependencies>
    <!-- 保留原有其他依赖 -->
    <!-- 替换旧的hibernate-search-orm -->
    <dependency>
        <groupId>org.hibernate.search</groupId>
        <artifactId>hibernate-search-mapper-orm</artifactId>
        <version>6.2.1.Final</version>
    </dependency>
    <dependency>
        <groupId>org.hibernate.search</groupId>
        <artifactId>hibernate-search-backend-lucene</artifactId>
        <version>6.2.1.Final</version>
    </dependency>
</dependencies>

搜索相关API调用方式（基于Hibernate Search 6） #

实体类注解调整 #

Hibernate Search 6的注解逻辑有更新，替换旧版注解示例：

import jakarta.persistence.Entity;
import org.hibernate.search.mapper.pojo.mapping.definition.annotation.FullTextField;
import org.hibernate.search.mapper.pojo.mapping.definition.annotation.Indexed;

@Entity
@Indexed // 核心注解保留
public class YourEntity {
    @FullTextField(termVector = org.hibernate.search.engine.backend.types.TermVector.YES)
    // 替代原@Field注解，termVector配置方式调整
    private String content;
    
    // 其他字段、构造方法、getter/setter
}

基于EntityManager的搜索实现 #

import jakarta.persistence.EntityManager;
import org.hibernate.search.engine.search.query.SearchQuery;
import org.hibernate.search.mapper.orm.Search;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class SearchService {
    private final EntityManager entityManager;

    public SearchService(EntityManager entityManager) {
        this.entityManager = entityManager;
    }

    public List<YourEntity> searchByContent(String keyword) {
        SearchQuery<YourEntity> searchQuery = Search.session(entityManager)
                .search(YourEntity.class)
                .where(f -> f.match()
                        .field("content")
                        .matching(keyword))
                .toQuery();

        return searchQuery.fetchAllHits();
    }
}

额外注意事项 #

• 清理本地Maven仓库中hibernate-core 5.4.33.Final的相关目录，彻底消除类加载冲突
• Hibernate Search 6的配置方式更新，示例application.yml配置：

spring:
  jpa:
    properties:
      hibernate.search.backend.type: lucene
      hibernate.search.backend.directory.type: local-filesystem
      hibernate.search.backend.directory.root: ./data/lucene-indexes

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