hibernate/hibernate-orm · error · ConnectionProviderConfigurationException

Class '{providerClassName}' does not implement 'ConnectionPr

Error message

Class '{providerClassName}' does not implement 'ConnectionProvider'

What it means

Error "Class '{providerClassName}' does not implement 'ConnectionProvider'" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/engine/jdbc/connections/internal/ConnectionProviderInitiator.java:125

			}
			else if ( explicitSetting instanceof Class<?> providerClass ) {
				CONNECTION_PROVIDER_LOGGER.instantiatingExplicitConnectionProvider( providerClass.getName() );
				return instantiateExplicitConnectionProvider( connectionProviderClass( providerClass ), beanContainer );
			}
			else {
				final String providerName = nullIfBlank( explicitSetting.toString() );
				if ( providerName != null ) {
					return instantiateNamedConnectionProvider( providerName, strategySelector, beanContainer );
				}
			}
		}

		return instantiateConnectionProvider( configurationValues, strategySelector, beanContainer );
	}

	private static Class<? extends ConnectionProvider> connectionProviderClass(Class<?> providerClass) {
		if ( !ConnectionProvider.class.isAssignableFrom( providerClass ) ) {
			throw new ConnectionProviderConfigurationException( "Class '" + providerClass.getName()
																+ "' does not implement 'ConnectionProvider'" );
		}
		return providerClass.asSubclass( ConnectionProvider.class );
	}

	private ConnectionProvider instantiateNamedConnectionProvider(
			String providerName, StrategySelector strategySelector, BeanContainer beanContainer) {
		CONNECTION_PROVIDER_LOGGER.instantiatingExplicitConnectionProvider( providerName );
		final var providerClass = strategySelector.selectStrategyImplementor( ConnectionProvider.class, providerName );
		try {
			return instantiateExplicitConnectionProvider( providerClass, beanContainer );
		}
		catch (Exception e) {
			throw new HibernateException( "Could not instantiate connection provider [" + providerName + "]", e );
		}
	}

	private ConnectionProvider instantiateConnectionProvider(

View on GitHub (pinned to fad1729dce)

Solutions

1. Make the configured class implement org.hibernate.engine.jdbc.connections.spi.ConnectionProvider
2. Fix the 'hibernate.connection.provider_class' setting to name a valid ConnectionProvider implementation

When it happens

Trigger: Thrown at hibernate-core/src/main/java/org/hibernate/engine/jdbc/connections/internal/ConnectionProviderInitiator.java:125 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/f3ba9edc4286af36. Report an issue: GitHub.