{"record":{"id":"351c1d4288e695d0","repo":"hibernate/hibernate-orm","slug":"null-keys-in-key-based-pagination-are-not-yet-supp","errorCode":null,"errorMessage":"Null keys in key-based pagination are not yet supported","messagePattern":"Null keys in key-based pagination are not yet supported","errorType":"exception","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"hibernate-core/src/main/java/org/hibernate/query/internal/KeyedResult.java","lineNumber":69,"sourceCode":"\t\t\t\t\tif (i < size) {\n\t\t\t\t\t\tresultList.add( executed.get(i).getResult() );\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tthrow new AssertionFailure(\"Unrecognized KeyInterpretation\");\n\t\t}\n\t\treturn resultList;\n\t}\n\n\t// Used by Hibernate Reactive\n\tpublic static List<List<?>> collectKeys(List<? extends KeyedResult<?>> executed, int pageSize) {\n\t\tfinal int size = executed.size();\n\t\tfinal List<List<?>> resultList = new ArrayList<>( size );\n\t\tfor ( int i = 0; i < size && i < pageSize; i++ ) {\n\t\t\tfinal List<Comparable<?>> key = executed.get(i).getKey();\n\t\t\tif ( key == null ) {\n\t\t\t\tthrow new IllegalArgumentException(\"Null keys in key-based pagination are not yet supported\");\n\t\t\t}\n\t\t\tresultList.add( key );\n\t\t}\n\t\treturn resultList;\n\t}\n}\n","sourceCodeStart":51,"sourceCodeEnd":76,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/query/internal/KeyedResult.java#L51-L76","documentation":"Error \"Null keys in key-based pagination are not yet supported\" thrown in hibernate/hibernate-orm.","triggerScenarios":"Key-based pagination preconditions are not met: Null keys in key-based pagination are not yet supported","commonSituations":"Using key-based pagination on queries with no/multiple roots, multi-item select lists, non-entity select items, or pages containing null key values.","solutions":["Null key values are not supported in key-based pagination. Ensure key columns are non-null, or use offset pagination."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"fad1729dce015f908198d57a8d80274a30f905a5","analyzedAt":"2026-08-22T04:13:57.527Z","schemaVersion":2},"datasetVersion":"2026-08-22T09:17:25.309Z"}