hibernate/hibernate-orm · error · IllegalArgumentException

Parameter with name '" + name + "' does not exist

Error message

Parameter with name '" + name + "' does not exist

What it means

Error "Parameter with name '" + name + "' does not exist" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/procedure/internal/ProcedureParamBindings.java:81

		if ( binding == null ) {
			if ( !parameterMetadata.containsReference( parameter ) ) {
				throw new IllegalArgumentException( "Passed parameter is not registered with this query" );
			}
			final var parameterBinding = new ProcedureParameterBindingImpl<>( procParam, sessionFactory );
			bindingMap.put( procParam, parameterBinding );
			return parameterBinding;
		}
		else {
			//noinspection unchecked
			return (ProcedureParameterBinding<P>) binding;
		}
	}

	@Override
	public ProcedureParameterBinding<?> getBinding(String name) {
		final var parameter = parameterMetadata.getQueryParameter( name );
		if ( parameter == null ) {
			throw new IllegalArgumentException( "Parameter with name '" + name + "' does not exist" );
		}
		return getQueryParameterBinding( (ProcedureParameterImplementor<?>) parameter );
	}

	@Override
	public ProcedureParameterBinding<?> getBinding(int position) {
		final var parameter = parameterMetadata.getQueryParameter( position );
		if ( parameter == null ) {
			throw new IllegalArgumentException( "Parameter at position " + position + "does not exist" );
		}
		return getQueryParameterBinding( (ProcedureParameterImplementor<?>) parameter );
	}

	@Override
	public void validate() {
		if ( LOG.isDebugEnabled() ) {
			parameterMetadata.visitRegistrations(
					parameter -> validate( (ProcedureParameterImplementor<?>) parameter ) );

View on GitHub (pinned to fad1729dce)

Solutions

1. Register a parameter with that exact name via registerStoredProcedureParameter first.
2. Check for spelling/case differences in the parameter name.

When it happens

Trigger: A stored procedure / query parameter is bound or referenced inconsistently with its registration.

Common situations: Calling StoredProcedureQuery or Query with missing, misnamed, or mixed named/positional parameters.

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