hibernate/hibernate-orm · error · ServiceException

Could not build explicit BatchBuilder [{builderClassName}]

Error message

Could not build explicit BatchBuilder [{builderClassName}]

What it means

Error "Could not build explicit BatchBuilder [{builderClassName}]" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/engine/jdbc/batch/internal/BatchBuilderInitiator.java:67

			final var discovered = discover( classLoaderService );
			return discovered != null
					? discovered
					: new BatchBuilderImpl( getInt( STATEMENT_BATCH_SIZE, configurationValues, 1 ) );
		}
		else if ( builder instanceof BatchBuilder batchBuilder ) {
			return batchBuilder;
		}
		else {
			final String builderClassName = builder.toString();
			try {
				return (BatchBuilder)
						classLoaderService
								.classForName( builderClassName )
								.getConstructor()
								.newInstance();
			}
			catch (Exception e) {
				throw new ServiceException( "Could not build explicit BatchBuilder [" + builderClassName + "]", e );
			}
		}
	}

	private static BatchBuilder discover(ClassLoaderService classLoaderService) {
		final var discovered = classLoaderService.loadJavaServices( BatchBuilder.class );
		final var iterator = discovered.iterator();
		if ( iterator.hasNext() ) {
			final var selected = iterator.next();
			if ( iterator.hasNext() ) {
				throw new ServiceException(
						"Multiple BatchBuilder service registrations found via ServiceLoader; "
						+ "specify one explicitly via '" + BUILDER + "'" );
			}
			return selected;
		}
		else {
			return null;

View on GitHub (pinned to fad1729dce)

Solutions

1. Verify the BatchBuilder class configured via 'hibernate.jdbc.batch.builder' has a suitable constructor and is on the classpath
2. Remove the custom setting to fall back to the default BatchBuilder

When it happens

Trigger: Thrown at hibernate-core/src/main/java/org/hibernate/engine/jdbc/batch/internal/BatchBuilderInitiator.java:67 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of hibernate/hibernate-orm@fad1729dce (2026-08-22). Data as JSON: /api/errors/84c60ec33371d1ee. Report an issue: GitHub.