hibernate/hibernate-orm · error · IllegalArgumentException

Unregistered converter type: " + type.getName()

Error message

Unregistered converter type: " + type.getName()

What it means

Error "Unregistered converter type: " + type.getName()" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/procedure/internal/ProcedureCallImpl.java:750

				registerParameter( parameterName, type, mode );
			}
		}
		catch (HibernateException he) {
			throw getExceptionConverter().convert( he );
		}
		catch (RuntimeException e) {
			getSession().markForRollbackOnly();
			throw e;
		}
		return this;
	}

	private BasicType<?> getConvertedType(Class<?> type) {
		final var convertedType =
				getNodeBuilder().getTypeConfiguration().getBasicTypeRegistry()
						.getRegisteredType( type.getTypeName() );
		if ( convertedType == null ) {
			throw new IllegalArgumentException( "Unregistered converter type: " + type.getName() );
		}
		return convertedType;
	}

	private <C> void registerParameterWithConverter(int position, BasicType<C> convertedType, ParameterMode mode) {
		registerParameter( new ProcedureParameterImpl<>(
				position,
				mode,
				getExpressibleJavaType( convertedType ),
				convertedType
		) );
	}

	private <C> void registerParameterWithConverter(String name, BasicType<C> convertedType, ParameterMode mode) {
		registerParameter( new ProcedureParameterImpl<>(
				name,
				mode,
				getExpressibleJavaType( convertedType ),

View on GitHub (pinned to fad1729dce)

Solutions

1. Register the AttributeConverter with the JPA persistence unit or Hibernate bootstrap.
2. Ensure the converter class has autoApply enabled or is listed in the mapping.

When it happens

Trigger: A runtime precondition of the Hibernate API is violated.

Common situations: Occurs when application code or configuration does not satisfy the documented contract of the API being called.

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