hibernate/hibernate-orm · error · IllegalArgumentException

Null keys in key-based pagination are not yet supported

Error message

Null keys in key-based pagination are not yet supported

What it means

Error "Null keys in key-based pagination are not yet supported" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/query/internal/KeyedResult.java:69

					if (i < size) {
						resultList.add( executed.get(i).getResult() );
					}
				}
				break;
			default:
				throw new AssertionFailure("Unrecognized KeyInterpretation");
		}
		return resultList;
	}

	// Used by Hibernate Reactive
	public static List<List<?>> collectKeys(List<? extends KeyedResult<?>> executed, int pageSize) {
		final int size = executed.size();
		final List<List<?>> resultList = new ArrayList<>( size );
		for ( int i = 0; i < size && i < pageSize; i++ ) {
			final List<Comparable<?>> key = executed.get(i).getKey();
			if ( key == null ) {
				throw new IllegalArgumentException("Null keys in key-based pagination are not yet supported");
			}
			resultList.add( key );
		}
		return resultList;
	}
}

View on GitHub (pinned to fad1729dce)

Solutions

1. Null key values are not supported in key-based pagination. Ensure key columns are non-null, or use offset pagination.

When it happens

Trigger: Key-based pagination preconditions are not met: Null keys in key-based pagination are not yet supported

Common situations: Using key-based pagination on queries with no/multiple roots, multi-item select lists, non-entity select items, or pages containing null key values.

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