Hibernate Search upgrade from 7.2.4 to 8.0.0

horvoje · June 16, 2025, 4:43pm

Hi!

When I try to upgrade Hibernate Search from 7.2.4 to 8.0.0 there is an error preventing application start:

*************************** APPLICATION FAILED TO START *************************** Description: An attempt was made to call a method that does not exist. The attempt was made from the following location: org.hibernate.search.mapper.orm.bootstrap.impl.HibernateOrmIntegrationBooterImpl.<init>(HibernateOrmIntegrationBooterImpl.java:75) The following method did not exist: 'org.hibernate.models.spi.ModelsContext org.hibernate.boot.spi.BootstrapContext.getModelsContext()' The calling method's class, org.hibernate.search.mapper.orm.bootstrap.impl.HibernateOrmIntegrationBooterImpl, was loaded from the following location: jar:file:/C:/Users/Hrvoje/.m2/repository/org/hibernate/search/hibernate-search-mapper-orm/8.0.0.Final/hibernate-search-mapper-orm-8.0.0.Final.jar!/org/hibernate/search/mapper/orm/bootstrap/impl/HibernateOrmIntegrationBooterImpl.class The called method's class, org.hibernate.boot.spi.BootstrapContext, is available from the following locations: jar:file:/C:/Users/Hrvoje/.m2/repository/org/hibernate/orm/hibernate-core/6.6.15.Final/hibernate-core-6.6.15.Final.jar!/org/hibernate/boot/spi/BootstrapContext.class The called method's class hierarchy was loaded from the following locations: org.hibernate.boot.spi.BootstrapContext: file:/C:/Users/Hrvoje/.m2/repository/org/hibernate/orm/hibernate-core/6.6.15.Final/hibernate-core-6.6.15.Final.jar Action: Correct the classpath of your application so that it contains compatible versions of the classes org.hibernate.search.mapper.orm.bootstrap.impl.HibernateOrmIntegrationBooterImpl and org.hibernate.boot.spi.BootstrapContext

The only difference was:

BooleanPredicateClausesStep<?>

which I had to change to:

BooleanPredicateClausesStep<?,?>

Other versions are:
Java: 21
Spring Boot: 3.5.0
Hibernate 7.0.2.Final

<properties>	<!-- <hibernate-search-mapper-orm.version>7.2.4.Final</hibernate-search-mapper-orm.version> -->	<hibernate-search-mapper-orm.version>8.0.0.Final</hibernate-search-mapper-orm.version> </properties> <dependencies>	<dependency>	<groupId>org.hibernate.search</groupId>	<artifactId>hibernate-search-mapper-orm</artifactId>	<version>${hibernate-search-mapper-orm.version}</version>	<exclusions>	<exclusion>	<groupId>org.hibernate.orm</groupId>	<artifactId>hibernate-core</artifactId>	</exclusion>	<exclusion>	<groupId>org.jboss.logging</groupId>	<artifactId>jboss-logging</artifactId>	</exclusion>	</exclusions>	</dependency>	<dependency>	<groupId>org.hibernate.search</groupId>	<artifactId>hibernate-search-backend-lucene</artifactId>	<version>${hibernate-search-mapper-orm.version}</version>	<exclusions>	<exclusion>	<groupId>org.jboss.logging</groupId>	<artifactId>jboss-logging</artifactId>	</exclusion>	</exclusions>	</dependency> </dependencies>

horvoje · June 16, 2025, 4:51pm

When I exclude old Hibernate Core (6.*) and manually add new Hibernate Core (7.0.2), then I get:

Caused by: java.lang.ClassNotFoundException: jakarta.persistence.PersistenceUnitTransactionType

which reminds me of the way I don’t want to go before asking.

mbekhta · June 16, 2025, 4:57pm

Hey hey

hmm yeah … this looks like a problem with dependencies
You’d want

Hibernate ORM 7.0
Hibernate Search 8.0
Hibernate Models 1.0 (above two should take care of that, but versions in ORM 7.0.0 and Search 8.0.0 are different and things won’t work nicely if you don’t force the version Search expects) but since you are already at 8.0.0 and 7.0.2 this shouldn’t be a problem
Jakarta Persistence 3.2.0

I suspect that Spring brings its own versions of some of the above and it is causing the issues … try running mvn dependency:tree to see what ends up in your dependencies and from where it comes from..

see the missing jakarta.persistence.PersistenceUnitTransactionType tells that it’s there since 3.2: PersistenceUnitTransactionType (Jakarta Persistence API documentation)

mbekhta · June 16, 2025, 7:01pm

One other hing I just though I’d mention to you, you know there’s the Hibernate Search BOM and Hibernate ORM platform files, right?

so if you do something like this:

github.com/hibernate/hibernate-search

build/parents/springtest/pom.xml

ec9891c91

  <dependencyManagement>
  <dependencies>
  <!-- Override the version of Hibernate ORM pulled by Spring Boot -->
  <!--
  Since we are importing a pom and not using it as a parent for this module,
  we cannot use a version property like:
  <hibernate.version>${version.org.hibernate.orm}</hibernate.version>
  or:
  <elasticsearch-client.version>${version.org.elasticsearch.client}</elasticsearch-client.version>
  to override Spring's dependency version with the one we need. Instead, we are going import our bom to
  override the versions. Placing it after the Spring bom - doesn't work and dependency versions
  remain unchanged.
  -->
  <dependency>
  <groupId>org.hibernate.orm</groupId>
  <artifactId>hibernate-platform</artifactId>
  <version>${version.org.hibernate.orm}</version>
  <type>pom</type>
  <scope>import</scope>
  </dependency>

This file has been truncated. show original

where you import the ORM platform + Search BOM before any Spring dependencies it may save you some troubles…

horvoje · June 16, 2025, 11:34pm

Thank you very much!
Now it’s working!
I had to add Jakarta Persistence 3.2 on top of all.

<properties> <hibernate-core.v>7.0.2.Final</hibernate-core.v>	<jakarta.persistence-api.v>3.2.0</jakarta.persistence-api.v> <hibernate-search.v>8.0.0.Final</hibernate-search.v>	</properties>	<dependencies>	<dependency>	<groupId>org.springframework.boot</groupId>	<artifactId>spring-boot-starter-data-jpa</artifactId>	<exclusions>	<exclusion>	<groupId>org.hibernate.orm</groupId>	<artifactId>hibernate-core</artifactId>	</exclusion>	</exclusions>	</dependency>	<dependency> <groupId>org.hibernate.orm</groupId> <artifactId>hibernate-core</artifactId> <version>${hibernate-core.v}</version><!--$NO-MVN-MAN-VER$-->	</dependency>	<dependency>	<groupId>jakarta.persistence</groupId>	<artifactId>jakarta.persistence-api</artifactId>	<version>${jakarta.persistence-api.v}</version><!--$NO-MVN-MAN-VER$-->	</dependency>	<dependency>	<groupId>org.hibernate.search</groupId>	<artifactId>hibernate-search-mapper-orm</artifactId>	<version>${hibernate-search.v}</version>	<exclusions>	<exclusion>	<groupId>org.hibernate.orm</groupId>	<artifactId>hibernate-core</artifactId>	</exclusion>	<exclusion>	<groupId>org.jboss.logging</groupId>	<artifactId>jboss-logging</artifactId>	</exclusion>	</exclusions>	</dependency>	<dependency>	<groupId>org.hibernate.search</groupId>	<artifactId>hibernate-search-backend-lucene</artifactId>	<version>${hibernate-search.v}</version>	<exclusions>	<exclusion>	<groupId>org.jboss.logging</groupId>	<artifactId>jboss-logging</artifactId>	</exclusion>	</exclusions>	</dependency>	<dependency>	<groupId>org.jboss.logging</groupId>	<artifactId>jboss-logging</artifactId><!--$NO-MVN-MAN-VER$-->	</dependency>	</dependencies>

alagappanseth · June 19, 2025, 7:04pm

Hello, I just stumble upon your talk and wanted to share two extra thoughts about this migration as I’m experiencing it myself currently.
Yes, it is good to remember that Hibernate Search 8.0 is the first release compatible with Hibernate ORM 7. x, and it does not work with ORM 6 at all. x in large part due to significant API changes. More so for the new Hibernate Models module which was introduced in ORM 7.0.

Regarding the ClassNotFoundException: jakarta. persistence. PersistenceUnitTransactionType issue, that is a common indication that you don’t have Jakarta Persistence 3.2. Hibernate ORM 7.0 has upgraded to this spec and Spring Boot (in particular versions before 3.2) brought in an older version by default.

There’s a good page about it in the Hibernate Search documentation wherein all the subtle details of migration from 7 are described. x to 8.0: Hibernate Search 8.0.0.Final: Migration Guide from 7.2

Good luck with the project!

Topic		Replies	Views
Upgrade from 7.1.1 to 7.2.0 throws exception(s) Hibernate Search	5	484	August 22, 2024
Error after upgrade to spring boot 3.4.2 Hibernate ORM	1	133	April 2, 2025
java.lang.NoSuchMethodError: 'java.lang.String org.hibernate.search.engine.Version.versionString() Hibernate Search	3	889	May 2, 2022
SPI / JMS, migrating to hibernate-search 6.x questions Hibernate Search	6	735	February 21, 2022
Hibernate Search + Elastic Search - Create Index method not found error Hibernate Search	1	705	April 2, 2020

Hibernate Search upgrade from 7.2.4 to 8.0.0

Related topics