hibernate/hibernate-orm · error · IllegalArgumentException

value list is empty

Error message

value list is empty

What it means

Error "value list is empty" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/query/range/ValueList.java:24

import jakarta.persistence.criteria.CriteriaBuilder;
import jakarta.persistence.criteria.Path;
import jakarta.persistence.criteria.Predicate;
import org.hibernate.internal.util.ReflectHelper;

import java.util.List;
import java.util.Objects;

/**
 * Restricts to a list of literal values.
 *
 * @author Gavin King
 */
record ValueList<U>(List<U> values) implements Range<U> {
	ValueList {
		Objects.requireNonNull( values, "value list is null" );
		if ( values.isEmpty() ) {
			throw new IllegalArgumentException( "value list is empty" );
		}
	}

	@Override
	public Predicate toPredicate(Path<? extends U> path, CriteriaBuilder builder) {
		return path.in( values );
	}

	@Override
	public Class<? extends U> getType() {
		return ReflectHelper.getClass( values.get(0) );
	}
}

View on GitHub (pinned to fad1729dce)

Solutions

1. The value list for the range is empty. Provide at least one value in the in-list/range.

When it happens

Trigger: A ValueList range is constructed with no values: value list is empty

Common situations: Creating an in-list restriction with an empty value list.

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