hibernate/hibernate-orm · error · IllegalArgumentException

Parameter at position " + position + "does not exist

Error message

Parameter at position " + position + "does not exist

What it means

Error "Parameter at position " + position + "does not exist" thrown in hibernate/hibernate-orm.

Source

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

			//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 ) );
		}
	}

	private <T> void validate(ProcedureParameterImplementor<T> procParam) {
		final var mode = procParam.getMode();
		if ( mode == ParameterMode.IN || mode == ParameterMode.INOUT ) {
			if ( !getBinding( procParam ).isBound() ) {
				// depending on "pass nulls" this might be OK - for now, just log a warning
				if ( procParam.isOrdinal() ) {

View on GitHub (pinned to fad1729dce)

Solutions

  1. Register a parameter at that position before binding (positions start at 1).
  2. Verify the registration order matches the bind positions.

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/8890dbeecd776a1b. Report an issue: GitHub.