hibernate/hibernate-orm · error · MappingException

Unable to resolve type specified for parameter (%s) defined

Error message

Unable to resolve type specified for parameter (%s) defined for @FilterDef (%s)

What it means

Error "Unable to resolve type specified for parameter (%s) defined for @FilterDef (%s)" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/boot/model/internal/FilterDefBinder.java:66

			throw new AnnotationException( "Multiple '@FilterDef' annotations define a filter named '" + name + "'" );
		}

		final Map<String, JdbcMapping> paramJdbcMappings;
		final Map<String, ManagedBean<? extends Supplier<?>>> parameterResolvers;
		final var explicitParameters = filterDef.parameters();
		if ( isEmpty( explicitParameters ) ) {
			paramJdbcMappings = emptyMap();
			parameterResolvers = emptyMap();
		}
		else {
			paramJdbcMappings = new HashMap<>();
			parameterResolvers = new HashMap<>();
			for ( var explicitParameter : explicitParameters ) {
				final String parameterName = explicitParameter.name();
				final var typeClassDetails = explicitParameter.type();
				final var jdbcMapping = resolveFilterParamType( typeClassDetails, context );
				if ( jdbcMapping == null ) {
					throw new MappingException(
							String.format(
									Locale.ROOT,
									"Unable to resolve type specified for parameter (%s) defined for @FilterDef (%s)",
									parameterName,
									name
							)
					);
				}
				paramJdbcMappings.put( parameterName, jdbcMapping );

				final var resolverClass = explicitParameter.resolver();
				if ( !Supplier.class.equals( resolverClass ) ) {
					parameterResolvers.put( explicitParameter.name(),
							resolveParamResolver( resolverClass, context ) );
				}
			}
		}

View on GitHub (pinned to fad1729dce)

Solutions

1. Use a resolvable type for the @FilterDef parameter (a valid Java type or registered type name).

When it happens

Trigger: A @Filter/@FilterJoinTable usage references an undefined filter or has no usable condition.

Common situations: @Filter used without a matching @FilterDef, a misspelled filter name, or neither the usage nor the FilterDef supplying a default condition.

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