hibernate/hibernate-orm · error · IllegalArgumentException

Undefined filter parameter '{}'

Error message

Undefined filter parameter '{}'

What it means

Error "Undefined filter parameter '{}'" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/internal/FilterImpl.java:112

		return parameters == null ? emptyMap() : unmodifiableMap( parameters );
	}

	/**
	 * Set the named parameter's value for this filter.
	 *
	 * @param name The parameter's name.
	 * @param value The value to be applied.
	 * @return This FilterImpl instance (for method chaining).
	 * @throws IllegalArgumentException Indicates that either the parameter was undefined or that the type
	 * of the passed value did not match the configured type.
	 */
	public Filter setParameter(String name, Object value) throws IllegalArgumentException {
		final Object argument = definition.processArgument( value );

		// Make sure this is a defined parameter and check the incoming value type
		final var type = definition.getParameterJdbcMapping( name );
		if ( type == null ) {
			throw new IllegalArgumentException( "Undefined filter parameter '" + name + "'" );
		}
		if ( argument != null && !type.getJavaTypeDescriptor().isInstance( argument ) ) {
			throw new IllegalArgumentException( "Argument assigned to filter parameter '" + name
					+ "' is not of type '" + type.getJavaTypeDescriptor().getTypeName() + "'" );
		}
		if ( parameters == null ) {
			parameters = new TreeMap<>();
		}
		parameters.put( name, argument );
		validated = false;
		return this;
	}

	/**
	 * Set the named parameter's value list for this filter.  Used
	 * in conjunction with IN-style filter criteria.
	 *
	 * @param name   The parameter's name.

View on GitHub (pinned to fad1729dce)

Solutions

1. Declare the parameter in the @FilterDef/@Filter definition, or fix the parameter name passed to setParameter.

When it happens

Trigger: Thrown when a filter is given a parameter that is not declared, of the wrong type, or lacking a value.

Common situations: Typical situations: typos in filter parameter names; setting a parameter of an incompatible Java type; forgetting to bind a parameter before running the query.

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