hibernate/hibernate-orm · error · IllegalArgumentException

Passed parameter is not registered with this query

Error message

Passed parameter is not registered with this query

What it means

Error "Passed parameter is not registered with this query" thrown in hibernate/hibernate-orm.

Source

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

	}

	@Override
	public boolean isBound(QueryParameterImplementor<?> parameter) {
		return parameter instanceof ProcedureParameterImplementor<?>
			&& bindingMap.containsKey( parameter );
	}

	@Override
	public <P> ProcedureParameterBinding<P> getBinding(QueryParameterImplementor<P> parameter) {
		return getQueryParameterBinding( (ProcedureParameterImplementor<P>) parameter );
	}

	public <P> ProcedureParameterBinding<P> getQueryParameterBinding(ProcedureParameterImplementor<P> parameter) {
		final var procParam = parameterMetadata.resolve( parameter );
		final var binding = bindingMap.get( procParam );
		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 );

View on GitHub (pinned to fad1729dce)

Solutions

1. Register the parameter on the ProcedureCall before binding a value to it.
2. Obtain the ParameterRegistration instance from the same ProcedureCall.

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/68b64abfccaee0b9. Report an issue: GitHub.