hibernate/hibernate-orm · error · UnsupportedOperationException

BatchBuilder does not support single-statement batches: {cla

Error message

BatchBuilder does not support single-statement batches: {className}

What it means

Error "BatchBuilder does not support single-statement batches: {className}" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/engine/jdbc/batch/spi/BatchBuilder.java:77

	 * for grouped mutation batching do not necessarily know how to build this
	 * specialization.  Builders that want to support graph-style single statement
	 * batching should override this method.
	 *
	 * @param key key identifying compatible rows for the batch
	 * @param batchSize explicit batch size override, or {@code null} to use the
	 * builder's default
	 * @param mutationOperation preparable mutation operation representing the
	 * single statement shape
	 * @param jdbcCoordinator JDBC coordinator that will own the active batch
	 *
	 * @return a single-statement batch instance
	 */
	default SingleStatementBatch buildSingleStatementBatch(
			BatchKey key,
			Integer batchSize,
			PreparableMutationOperation mutationOperation,
			JdbcCoordinator jdbcCoordinator) {
		throw new UnsupportedOperationException(
				"BatchBuilder does not support single-statement batches: " + getClass().getName()
		);
	}
}

View on GitHub (pinned to fad1729dce)

Solutions

1. Use a multi-statement batch or a BatchBuilder that supports single-statement batches
2. Do not submit single-statement batches to this BatchBuilder implementation

When it happens

Trigger: Thrown at hibernate-core/src/main/java/org/hibernate/engine/jdbc/batch/spi/BatchBuilder.java:77 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/808ab6e35c698524. Report an issue: GitHub.